This is a starter to try the elm-pages 3.0 Release Candidate. Any feedback would be very helpful for getting the release ready to go!
You can try this out on Netlify in just a couple of clicks with this button:
You can clone this repo with git clone https://github.com/dillonkearns/elm-pages-3-alpha-starter.git
.
npm install
from the cloned repo. Before running the dev server or build, make sure to install Lamdera (see below).
npm start
starts the dev server with hot reloading.
npm run build
builds the app for production.
Install Lamdera with these instructions.
elm-pages
3.0 uses the lamdera compiler, which is a superset of the Elm compiler with some extra functionality to automatically serialize Elm types to Bytes. That means there is no more OptimizedDecoder
API, you can just use regular elm/json
Decoders! And no more DataSource.distill
, since types are now automatically serialized all those optimizations come for free.
Sometimes Lamdera will give compiler errors due to corrupted dependency cache. These messages will display a note at the bottom:
-- PROBLEM BUILDING DEPENDENCIES ---------------
...
Note: Sometimes `lamdera reset` can fix this problem by rebuilding caches, so
give that a try first.
Be sure to use lamdera reset
to reset the caches for these cases. See more info about that in the Lamdera docs: https://dashboard.lamdera.app/docs/ides-and-tooling#problem-corrupt-caches
Check out the 3.0 Package Docs. The 3.0 docs are still a work in progress. As part of the final release, I will be going through and filling in documentation and updating missing docs. Feel free to make a pull request to update or add docs, or share feedback on the APIs and naming.
You can also use npx elm-pages docs
from your project to view the documentation for the RouteBuilder
module.
npm install
npx elm-pages run script/src/AddRoute.elm User.Id_
- now you can try out the generator! And you can tweak it, or even define new generator modules in thescript/
folder! You can also shorten this command tonpx elm-pages run AddRoute User.Id_
if you prefer.