The asset pipeline for ambitious web applications

yarn add --dev broccoli broccoli-cli
Requires Node v6+

Welcome to Broccoli.js

So what is Broccoli? ⚭

Broccoli is a Javascript build tool that exposes a simple Javascript API to perform file-based transformations, allowing developers to easily build complex build pipelines, using a simple, functional API.

Why choose Broccoli? ⚭

Blazing fast ⚑️

Broccoli's incremental rebuild system gives you sub-second compile times even when you're working with hundreds of files.

Less (code) is more πŸ“‰

Broccoli's ecosystem of high-quality plugins means you only have to write a few lines of code for most common tasks.

Flexible πŸ€Έβ€

Use Broccoli by itself, or as part of a larger system like Grunt, Rails, ember-cli, or even make. Broccoli don't care, it just builds what it's told.

It's Just Javascript πŸ™Œ

A Brocfile.js is just an ES6 module – use the Javascript you already know to specify how to build your assets.

Broccoli simply orchestrates file transformations via plugins. Plugins perform the actual work and operate on files, Broccoli coordinates the inputs and output of plugins.

Broccoli provides a simple, functional javascript API for constructing your build pipeline.

Example pipeline ⚭

/* Brocfile.js */

import SassSourceMaps from 'broccoli-sass-source-maps';
import Sass from 'sass';
import babel from 'broccoli-babel-transpiler';
import merge from 'broccoli-merge-trees';

const compileSass = SassSourceMaps(Sass);

const appRoot = 'app';

const styles = compileSass([appRoot], 'styles/app.scss', 'assets/app.css');
const scripts = babel(appRoot);

export default () => merge([styles, scripts]);

The above is an example of a simple Broccoli build pipeline that compiles Sass files and transcodes javascript using Babel, then merges the result into an output directory.