Single Page App Boilerplate

Single Page App Boilerplate allows you to easily and quickly create single page javascript applications using best practices such as test driven development, javascript dependency management, automated builds, and (coming soon) continuous deployment. Goals

Make test driven development in javascript easy
Automate javascript builds leveraging dependency management.
Make continuous integration of web user interfaces easy
Automate deployment of single page apps (coming soon)
Provide a solid foundation wiring together popular front end libraries in an easy to use way

Based on html5 boilerplate
Backbone, jquery, underscore, handlebars, requirejs, and modernizr are all wired together and ready to use
Write your javascript unit and integration tests in jasmine
One command to launch the jasmine browser based test runner
One command to run then jasmine unit and integration tests across all browsers you support using js-test-driver
One command to concatentate and minify your javascript and css
One http request to load your deployed javascript
Precompile your handlebars templates
Automatically deploy unminified version of your app at a different url in case you need to debug once deployed
Track ui screen transitions in google analytics every time your Backbone router url changes
Automatic browser back button support using Backbone's router
Easily localize your application with the requirejs-handlebars-plugins I18N support
Runs on OSX, Windows, and Linux
MIT licensed.

git clone https://github.com/davidjnelson/single-page-app-boilerplate.git --recursive
cd single-page-app-boilerplate/application-server
mvn jetty:run & to launch a development web server accessible at http://localhost:8080
mvn jasmine:bdd & to launch a jasmine spec runner at http://localhost:8234
java -jar ../bin/JsTestDriver.jar --port 9876 & to launch a js-test-driver server at http://localhost:9876
open all the browsers you want to test your code in, navigate to http://localhost:9876 in each and click 'Capture Browser'
mvn test to run your jasmine unit and integration tests across all browsers you captured
import the project into your favorite IDE by importing the maven pom.xml file
add your jasmine specs to src/test/specs. Wrap your jasmine specs in requirejs define calls. See HelloWorldViewTest.js for an example.
add your app code to src/main/webapp/js.{ }Router.js is your application entry point. If you want to use more than one router you can create more instances of Router in main.js.
add your google analytics account number to src/main/webapp/js/Constants.js
mvn install -P optimize to minify and concatenate css. Your deployable site will be output to target/minified-output. To use the optimized version, load index.html. To use the debug version, load index_unminified.html.

Run your integration tests during continuous integration only for faster development
jshint integration
deployment to the cloudfront cdn using an s3 or elastic beanstalk origin while setting gzip and caching http headers
no modifications made javascript libraries by using requirejs shims. currently libraries are wrapped with an AMD module
One command to update your javascript libraries to their latest versions
Integrate with yeoman for scaffolding for major js libraries other than Backbone
One command to rollback your application to a different version