elm serverless demo
This repo demonstrates how to use 
elm-serverless see the demo embedded in that repo
Run locally
We use serverless-offline to run the server locally during development. To get started, clone this repo and then:
npm installnpm start
Which will start a server listening on port 3000. Note that the demo includes multiple, independent, elm-serverless programs which are deployed as a bundle. Each program contains:
API.elm- the main entry point of the Elm HTTP APIapi.js- a small bridge from JavaScript to Elm
Learn by reading the demos in the following order:
| Demo | Path | Description |
|---|---|---|
| Hello | / | Bare bones hello world app. |
| Routing | /routing | Parse request path into Elm data. |
| Forms | /forms | Shows how to parse a JSON body. |
| Config | /config | Load per-instance configuration. |
| Pipelines | /pipelines | Build chains of middleware. |
| SideEffects | /side-effects | Handle effects in the update loop. |
| Interop | /interop | Call JavaScript functions. |
| Quoted | /quoted | Shows one way to organize a project. |
See serverless.yml and webpack.config.js for details on how elm-serverless apps get mapped to base paths.
Deploy to AWS Lambda
Setup AWS_REGION, AWS_ACCESS_KEY_ID, and AWS_SECRET_ACCESS_KEY in your environment. Make sure you have sufficient permissions to perform a serverless deployment (either admin rights, or something more restricted). Then npm run deploy:demo. If all goes well you'll see something like this in the output:
endpoints:
ANY - https://***.execute-api.us-east-1.amazonaws.com/dev/
ANY - https://***.execute-api.us-east-1.amazonaws.com/dev/{proxy+}Call the first endpoint to test your deployed function.
How it works
Two tools are involved in getting your elm app on AWS Lambda:
- webpack along with elm-webpack-loader compiles your elm code to JavaScript
- serverless along with serverless-webpack packages and deploys your app to AWS Lambda