Name: purescript-halogen-template
Owner: SlamData, Inc.
Description: Template project for getting started with Halogen
Created: 2016-01-18 20:34:51.0
Updated: 2018-05-17 18:43:58.0
Pushed: 2018-02-07 14:12:01.0
Homepage: null
Size: 16
Language: PureScript
GitHub Committers
User | Most Recent Commit | # Commits |
---|
Other Committers
User | Most Recent Commit | # Commits |
---|
This is a template for starting a fresh project using the purescript-halogen library for declarative user interfaces.
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:
install --global bower
First clone the repo and step into it:
clone https://github.com/slamdata/purescript-halogen-template.git my-halogen-project
y-halogen-project
If you don't already have a global installation of the PureScript compiler and Pulp (or you want a local installation with the appropriate versions) you can run:
install
Finally you'll need to install the PureScript library dependencies for this project with Bower:
r install
The project can now be built with:
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:
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:
run watch
To start a process that will watch the source files and trigger a reload whenever they are modified. Alternatively…
purs ide
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:
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.
:warning: 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.