elm-0.19-workshop/README.md

This workshop is licensed under a Creative Commons Attribution 4.0 International License. The server/ directory uses moleculer-node-realworld-example, which has its own license. The rest of the code is a variation on elm-spa-example, an MIT-licensed implementation of the realworld front-end. Many thanks to the authors of these projects!

Getting Started

1. Install Node.js 7.0.0 or higher

2. Clone this repository

Run this at the terminal:

git clone https://github.com/rtfeldman/elm-0.19-workshop.git
cd elm-workshop

3. Start the server

We'll be running a local server for our Elm UI to use. Let's get it set up.

cd server
npm install
npm start

If the server started up successfully, you should see > moleculer-runner services at the end of your terminal.

We're going to leave this server running and not touch it again for the duration of the workshop, so don't close it until the workshop is over!

Build the Elm UI

Leave the existing terminal running, and open a second terminal.

In the new termnal, cd into the elm-workshop/server/ directory again.

Then run this to build the Elm code for the first time:

elm make src/Main.elm --output=../server/public/elm.js --dir=../server/public --pushstate

It should say "Server running at" and "LiveReload running on" - but we'll ignore both of those, because we'll instead be using the server we already started running in the previous step!

Leave elm-live running and open http://localhost:3000 in your browser. You should see this in it:

If things aren’t working, the instructor will be happy to help!

Links

• Elm in Action, a book by Richard Feldman, creator of this workshop
• Official Elm Guide by Evan Czaplicki, creator of Elm
• Elm Slack - amazingly helpful chat community. People in the #beginners channel are happy to answer questions!
• Elm Discourse - for longer-form discussions.