This project was developed using the purescript-halogen-template.
This guide assumes you already have Git and Node.js installed with npm somewhere on your path.
In the PureScript ecosystem Bower is currently the most commonly used package manager and we’ll be relying on it for this project, so if you don’t already have it, you can install it like this:
$ npm install --global bower
The project can now be built with:
$ npm run build
This will build the PureScript source code and produce a bundled JS file as dist/app.js.
This is an alias for the Pulp command:
$ pulp build --to dist/app.js
If you open dist/index.html
you should now have a basic working
Halogen app.
You can also use the command:
$ npm run watch
To start a process that will watch the source files and trigger a reload whenever they are modified. Alternatively…
If you’re using an editor that supports purs ide
or running
pscid there’s an option for getting near-instant builds of the app
while you work on it:
$ npm run watch-fast
This will start a watch process that uses Webpack to rebundle the
app whenever the output files are changed. Since purs ide
rebuilds modules on save, this means you can use this much faster
bundle-only rebuild script.
Note: purs ide
only rebuilds one module at a time, so sometimes
the bundle will end up in an inconsistent state, resulting in
runtime errors. This occurs when a change is made in one module
that breaks other modules that depend on it. The solution is to
run a full build when a change like this is made, as the compiler
will force you to resolve those errors.