PB&J for Brunch

Brunch skeleton/boilerplate for developing HTML5 applications. Main languages are Javascript, CSS/Stylus and Handlebars.

Features

• Brunch workflow automation.
• Backbone/Chaplin provides the application architecture.
• Handlebars for semantic templating.
• Stylus for css preprocessing.
• Bootstrap 3 for some UI/UX goodness.
• Bower is used for front-end package management.
• HTML5 Boilerplate as a HTML5 application starting point.
• Modernizr for feature detection.
• JSHint for javascript linting.
• [Framework TBD] for testing.

Getting Started

Must have node.js installed. Optionally have Brunch and Bower globally installed.

Installation

Create a new application via Brunch@1.7.6.

brunch new git@github.com:nesbert/pbj-for-brunch.git <new-pbj-application>

Or clone this repository locally and install dependencies.

# clone and name application
git clone git@github.com:nesbert/pbj-for-brunch.git <new-pbj-application>

# change to project directory
cd <new-pbj-application>

# install application dependencies
npm install

Workflow

Brunch commands can be used to build and deploy the application.

# continuous incremental rebuild + web server (dev version)
./node_modules/.bin/brunch w -s

# build for deployment (optimized version)
./node_modules/.bin/brunch b -o

# view aplication
open http://localhost:3333

The Stack

Made by OSS <3.

• Backbone
• Brunch
• Bootstrap 3
• Bower
• Chaplin
• Handlebars
• HTML5 Boilerplate
• JSHint
• jQuery
• Modernizr
• node.js
• Stylus
• Underscore

License

MIT