Build Better Gulpfiles

asset-builder assembles and orchestrates your dependencies so you can run them through your asset pipeline. Easily create gulp tasks you can share between projects by separating config from code.

GitHub Repo

npm version Coverage Status

Automate Repetitive Glob Building.

asset-builder allows you to declare the output of your Gulpfile in an external manifest file.

manifest.json

{
  "dependencies": {
    "app.js": {
      "files": [
        "scripts/services/**/*.js",
        "scripts/controllers.js",
        "scripts/main.js"
      ],
      "main": true
    }
  }
}

So you can stop doing this...

gulpfile.js

gulp.src([
  'bower_components/jquery/jquery.js',
  'bower_components/bootstrap/component.js',
  'scripts/services/**/*.js',
  'scripts/controllers.js',
  'scripts/main.js'
])
  .pipe(concat('app.js'))
  .pipe(minify())
  .pipe(gulp.dest('dist'));

...and start doing this

gulpfile.js

gulp.src(js.globs)
  .pipe(concat(js.name))
  .pipe(minify())
  .pipe(gulp.dest(manifest.paths.dist));

Automate Repetitive Glob Building.

Install

npm install asset-builder --save-dev
In your project directory.

Use

var manifest = require('asset-builder')('./assets/manifest.json');
In your Gulpfile.

Examples

Manifest Specification

Learn about the JSON manifest asset-builder reads.

Module API Documentation

Detailed rundown of asset-builder's public and private API.

Annotated Source

Walk through the asset-builder source line by line.