AssembleJS

A light bootstrap for fast front-end development based on Backbone, Handlebars, RequireJS, SASS, and Twitter Bootstrap.

About

The focus of Assemble is to get up and running quickly with a collaborative application bootstrap, getting as much of the painful overhead out of the way without imposing too many dependencies. The HTML partials are Handlebars-compiled templates. I decided not to use JS preprocessing (Coffeescript, Typekit), and for CSS pre-processing, I decided to use Compass with the Twitter Bootstrapport for SASS.

I'd love to get feedback on whether this is too opinionated, or if there are better options to use. The goal is to allow for dependency options when building a project, similar to Yeoman.

Requirements

As far as level of understanding, it would best to be familiar first with Backbone and RequireJS.

/build

This directory contains a useful bash script update_requirejs.sh for updating the require.js library, the r.js compiler used by the build system, and app.build.js which should map to app/src/config.js

Environment Specific Paths

You can set environment specific paths in utils/env.js. By setting the ajax_prefilter property, all AJAX requests will prepend this path to the request https://github.com/nick-jonas/assemblejs. To get the environment id (i.e. "Local", "Dev", "Prod") at any point in the application, make sure you include utils/env in your module dependency array, and call

Env.getID();

To get an environment value, you would call

Env.getValue('my-key');

Routing

router.js is where the routing is defined, and acts as the controller for the application. The .htaccess file included forces all requests to index.html. Push state is enabled by default, and falls back to #hash if the browser does not support it.