Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
brunch is a lightweight client side framework on top of backbone, eco, stylus and coffee-script.
JavaScript CoffeeScript

This branch is 34 commits ahead of effkay:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
gem
npm
readme.md

readme.md

Early alpha, please use with caution!

brunch is lightweight client side framework on top of backbone.js, eco and stylus using coffee-script

How to Install

you can get brunch using the node package manager

npm install brunch

How to Use

create a new project using 'proj' as app namespace

brunch new <proj>

start the file watcher to process all .coffee, .sass or .html file changes automatically

brunch watch

build the project

brunch build

brunch provides the possibility to choose between different project templates currently these are available

  • express (default)
  • base

you can choose between them via option "--projectTemplate"

brunch new my_app --projectTemplate base

project templates

base

Just the basic brunch layout including src, config and build.

express

Includes build in express server which will be started with "brunch watch". You can take a look at the app at "localhost:8080".

Standing on the Shoulders of Giants

Instead of reinventing the wheel, brunch assembles awesome wheels.

Development

Watch coffeescript files and compile them via

cake watch

and run tests via

cake test

Contact

Feel free to contact us at Freenode #brunch in the IRC client of your choice.

TODO

  • more & improved documentation
  • tests
  • fancy welcome page
  • come up with a require solution
  • add support for subfolders - see issue #16
  • add collections folder
  • move concatination.js to app.js
  • provide option to set docs output path
  • fix bug (dispatch is called multiple times)
  • add information about source to reset.styl
  • directly call fusion, stylus and coffeescript instead of spawning child process
  • merge js files into app.js (call coffeescript compile manually)
  • copy css files to build

other stuff

  • add zepto to brunch cdn

Future plans

  • add "build deploy" which generates index.html with script tags using cdn
  • add phonegap support
Something went wrong with that request. Please try again.