elm-pages-v3-beta/site
2019-08-02 10:30:27 -07:00
..
content Generate raw content for markdown files. 2019-08-02 06:29:34 -07:00
gen Generate raw content for markdown files. 2019-08-02 06:29:34 -07:00
images Update example site with latest elm package code. 2019-07-29 15:20:52 -07:00
src Avoid parsing markdown frontmatter a second time. 2019-08-02 07:09:07 -07:00
.gitignore Change file structure. 2019-07-23 08:50:51 -07:00
elm.json Add markdown parsing with hardcoded RawContent file. 2019-08-02 05:29:31 -07:00
package-lock.json Bump CLI version in example site. 2019-08-02 10:30:27 -07:00
package.json Bump CLI version in example site. 2019-08-02 10:30:27 -07:00
prerender.config.js Update example site with latest elm package code. 2019-07-29 15:20:52 -07:00
README.md Change binary and naming to elm-pages. 2019-07-29 11:56:41 -07:00
tsconfig.json Update example site with latest elm package code. 2019-07-29 15:20:52 -07:00

elm-pages

Static site generator for elm-markup.

Getting Started

Install Dependencies

npm install

Running Locally

npm start

Will compile your app and serve it from http://localhost:1234/ Changes to your source code will trigger a hot-reload in the browser, which will also show compiler errors on build failures.

Running Tests

npm test

or

npm run autotest

To re-run tests when files change.

Production build

npm run build

Will generate a production-ready build of your app in the dist folder.

Elm Commands

Elm binaries can be found in node_modules/.bin. They can be run from within your project via npx

To install new Elm packages, run:

npx elm install <packageName>

Libraries & Tools

These are the main libraries and tools used to build elm-pages. If you're not sure how something works, getting more familiar with these might help.

Elm

Elm is a delightful language for creating reliable webapps. It guarantees no runtime exceptions, and provides excellent performance. If you're not familiar with it, the official guide is a great place to get started, and the folks on Slack and Discourse are friendly and helpful if you get stuck.

Elm Test

This is the standard testing library for Elm. In addition to being useful for traditional fixed-input unit tests, it also supports property-based testing where random data is used to validate behavior over a large input space. It's really useful!

Parcel

Parcel build and bundles the application's assets into individual HTML, CSS, and JavaScript files. It also runs the live-server used during development.