kwand-stack/README.md

Koa + WebSockets + Angular + Node + Dokku

KWAND Stack
===========
Koa · WebSockets · Angular · Node · Dokku

**JavaScript Full Stack Development for the Next Generation Web**  

Docs and more at [kwand.io](http://kwand.io).

Install
=======

To start your own project from the boilerplate:

1. Create a git repo
1. `cd` into your new repo
1. `wget https://raw.github.com/kwand/kwand-stack/master/kwand-stack.zip`
1. `unzip kwand-stack.zip`
1. `rm kwand-stack.zip`

(TODO: put all this into a single `npm install -g kwand; cd <repo>;
kwand init`)

Then, assuming you have `node >= 0.11.9` installed:

1. Customize `init` (if you want to add or remove anything)
1. `./init` (to grab latest and put them in `package.json`)
1. Customize `package.json`
1. Customize `app.json` (for Heroku/Dokku)
1. Remove `client` (and possibly `server`) from `.gitignore`

TODO
====

Still very much a work in progress, but functional.

* Add rewrite for trailing `/`
* Isolate the gulp-autoprefixer bug causing 'styles' watch to hang
* Add mocha testing
* Add superagent testing
* Shift to TDD (now that this thing is bigger and shareable)
* Add angular boiler
* Add src/server/crud samples
* Add src/server/service samples
* Add 'ws' to server 
* Add 'socket.io' to client 
* Add mongodb hooks
* Add travis testing
* Add a cache buster
* Setup analytics
* Consistent path.join throughout
* Add src/client/scripts/{after,before}/inline
* Add gulp-lazyload