Cljs Full Stack

Yeoman generator for building web applications leveraging ClojureScript on both the front-end and back-end.

Features:

* Livereload of client and server files
* Easy distribution generation
* Stack traces with source maps applied in Node.js
* Support for testing using Specljs
* Support for Sass and Compass

Requirements

* Yeoman (>=1.1.2)
* [Node.js]() (>=0.10.26)
* Grunt (>=4.2)
* Compass (>=0.12.2)
* Leiningen (>=2.3.2)

Usage

First, install the generator:

``
npm install -g generator-cljs-fullstack
`

If you want to do development on the generator itself, do this instead:

`
git clone https://github.com/johntrimble/generator-cljs-fullstack.git
cd generator-cljs-fullstack
npm install
npm link
`

Then create a new project by executing the following:

`
mkdir my-project
cd my-project
yo cljs-fullstack
`

$3

`
grunt serve
`

This will:

* Compile ClojureScript source
* Compile Sass source
* Start a node server running backend code at http://localhost:4000
* Start a static content server at http://localhost:9000
* Proxies http://localhost:9000/api/ to http://localhost:4000/api/
* Live reloads the browser on content changes (updating ClojureScript code, HTML, CSS, etc.)

Assuming there are no errors, this task should automagically open up a browser window to http://localhost:9000.

If you'd like to have your tests run continuously in the background as well, use the --with-tests options:

`
grunt serve --with-tests
`

$3

`
grunt
`

This will:

* Compile ClojureScript server source
* Compile ClojureScript client source with advanced mode
* Compile Sass source
* Concatenate and minify JavaScript source
* Minify HTML source
* Put all backend assets under dist
* Put all frontend assets under the dist/public directory
* Generate a suitable package.json at dist/package.json

Assuming there are no errors, the dist directory will be a self contained distribution of the application. The application can be started by running the following:

`
cd dist
npm install
npm start
`

$3

`
grunt test
`

This will:

* Compile ClojureScript source for the backend and frontend
* Run the backend and frontend tests

Note: This effectively runs lein cljsbuild once` twice, once for the backend and once for the frontend. This means it's slow. If you plan on running tests continuously, you may want to look at running in develop