es

elm-server

npm package for compiling, serving, and hot-reloading Elm code

Showing:

Popularity

Downloads/wk

4

GitHub Stars

26

Maintenance

Last Commit

5yrs ago

Contributors

1

Package

Dependencies

5

Size (min+gzip)

74.6KB

License

MIT

Type Definitions

Tree-Shakeable

No?

Categories

Readme

elm-server

An npm package for compiling, serving, and hot-reloading Elm code.

Installation

$ npm install -g elm-server

Getting started

By default elm-server will direct produce and serve an html file in your current directory.

$ elm-server path/to/Main.elm

Usage

  Usage: bin [options] <inputFile> [inputFiles...]

  Options:

    -h, --help               output usage information
    -V, --version            output the version number
    -o, --output <path>      Path to elm-make output [index.html].
    -s, --start-path <path>  Initial path when opening browser.
    -w, --watch <directory>  Path to served directory.  Defaults
                              to directory of output file path.
output

In most cases you'll want to specify an output file path in your project's assets directory.

$ elm-server src/elm/Main.elm --output assets/index.html
watch

Specifying a watched directory is useful when you want to serve assets in development which aren't generated from elm-make, like images and css.

$ elm-server src/elm/Main.elm --output assets/html/index.html --watch assets

This will allow elm-server to serve all files in the assets directory.

start-path

The initial path opened in the browser on start, for convenience.

$ elm-server src/elm/Main.elm \
    --output assets/js/elm.js \
    --watch assets \
    --start-path html/index.html

Programmatic Usage

In addition to providing a cli, elm-server can also be called programmatically.

const elmServer = require('elm-server');

elmServer('src/elm/Main.elm', {
  output: 'assets/js/elm.js',
  watch: 'assets'
});

or in the case of multiple entrypoints,

const elmServer = require('elm-server');

elmServer(['src/elm/Main1.elm', 'src/elm/Main2.elm']);

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100
No reviews found
Be the first to rate

Alternatives

No alternatives found

Tutorials

No tutorials found
Add a tutorial