Create generators/ directory in your brunch application
(directory name is customizable by config.paths.generators).
Create generator directory there with generator.json and
files that will be generated.
Conventions are configurable via config.conventions[name].
Convention can be a RegExp or Function.
assets convention: all files in directories that named as assets
(default value) will be copied to public path directly.
vendor All files in directories that named as vendor
(default value) won't be wrapped in modules.
tests convention: all files that end with _test.<extension>
(default value) are considered as test files and will be loaded
automatically with brunch test.
ignored convention: all files that start with _ (default value)
are considered as partial files and won't be compiled. Useful for
Stylus / Sass languages. This replaces functionality of
Added AMD support by allowing more flexibility with file wrapping:
config.modules can be an object of:
config.modules.wrapper - string, boolean or function,
defines how to wrap files in app directory in modules.
config.modules.definition - string, boolean or function, defines
what to add on top of every file.
Added linting support. Linting is a static analysis of code. Example
tools for this are JSHint, CSSLint etc. The lint API is
plugin.lint(data, path, callback). One file can use more than one linter.
Added support for Mac OS X Mountain Lion notification center.
You'll need to place
to /Applications/ to get it work.
Removed support for:
Brunch will automatically detect extension from your generator file name.
config.framework, config.generators. It's not needed because
all generators are local to your application and because
brunch now has generators/ directory.
Array type of paths.vendor / paths.assets. They're replaced by
If any error happened in brunch build,
it will exit with error code 1 instead of 0.
Fixed commonjs require_definition in <IE9.
Brunch 1.3.4 (July 7, 2012)
Fixed bug with too fast compilations.
Brunch 1.3.3 (June 29, 2012)
Added node.js 0.8 and 0.9 support.
jsdom, required for brunch test can now be installed once
for all apps via npm install -g jsdom. You'll need to have its
parent dir in NODE_MODULES env variable.
Fixed compiled in timer and brunch generate bugs.
Brunch 1.3.2 (June 27, 2012)
Fixed brunch test on new projects.
Brunch 1.3.1 (June 22, 2012)
Config can now be in any language you use in app (e.g. livescript).
Added --reporter (-r) option to brunch test which allows to choose
Made require definition much easier for debugging.
Brunch 1.3.0 (June 19, 2012)
Brunch with Chaplin is now the default application skeleton, that will be
created on brunch new <app>. Old one is still available with
brunch new <app> -s github://brunch/simple-coffee-skeleton.
Chaplin is an awesome set of classes on top of Backbone.js that
makes making big webapps very simple.
Added testing support (thanks to Andreas Gerstmayr):
Mocha is used as test engine.
It's a feature-rich, flexible and fun.
brunch test (or brunch t) is used to run all tests in CLI env.
Improved command line API:
Added github://user/repo skeleton address schema support to brunch new.
Debug mode now has logger namespaces. Usage:
BRUNCH_DEBUG=<ns> brunch <command> where <ns> is:
watcher, writer, *.
Improved file watcher:
Vim backup files are now ignored by watcher.
Fixed watching of non-compiled files in app.
Improved config API:
Added support for config.server.base, which determines base URL
from which to serve the app. The default value is empty string.
config.paths.ignored now doesn't need to check versus if
file is config.coffee or package.json, it does it automatically
in brunch code.
Fixed config.paths.ignored on windows.
config.paths.vendor is now an array, but it will be soon deprecated.
Changed onCompile plugin API. Now it receives an array of
fs_utils.GeneratedFile. This makes it very rich and allows to build smarter
reloaders. For example, the ones that reload browser tabs only on stylesheet
Semicolon is now added after every compiled vendor library because of
some libs that break with brunch. Hello, Zepto!
Styles in vendor directory are now sorted correctly, before app files.
Only generated files that depend on changed in current compilation files
are written now. Before, brunch was writing all files each time.
Brunch 1.2.2 (May 24, 2012)
Brunch now outputs compilation time.
Assets are copied one-by-one on change, instead of copying the whole
assets directory. This improves watcher performance by about 25%+.
Disabled caching in built-in webserver.
Improved brunch generate:
Added --plural option to brunch generate. Plural version of generator
name is used in controllers and collections. By default, brunch does pluralizing
instead of you.
Added collection generator to brunch generate. It is not included in
brunch g scaffold, because it's not needed most of the time.
Added collectionView generator to brunch generate for Chaplin users.
It doesn't generate corresponding template.
If package.json or config.coffee were removed during the watching,
brunch process will exit.
Maximum time between changes of two files that will be considered
as a one compilation changed from 100ms to 65ms.
Brunch 1.2.1 (May 12, 2012)
Fixed persistence of process with brunch watch (without server).
Fixed watching of files on windows.
Brunch 1.2.0 (May 12, 2012)
Greatly improved brunch generate:
User can now define his own generators in config.generators.