ngryman / gulp-bro

:punch: gulp + browserify + incremental build, done right.

gulp + browserify + incremental build, done right.

---

👋 Hey there, this repository is not maintained anymore. I unfortunately don't have enough bandwidth to maintain it. If you are interested in becoming a contributor and help keeping the boat afloat, please let me know by opening an issue.

---

Even through gulp has recipes to make things work, configuring browserify needs too much boilerplate and understanding about how things work. gulp-bro looks like any other gulp plugin, it does the exact same thing you can do manually, but hides the ugly stuff for you.

It also support incremental build out of the box, so you don't have to mess with watchify again.

Install

npm install --save-dev gulp-bro

Usage

Simple build

gulp.task('build', () =>
  gulp.src('app.js')
    .pipe(bro())
    .pipe(gulp.dest('dist'))
)

gulp.watch('*.js', ['build'])

Subsequent calls to build will be fast thanks to incremental build.

Browserify transforms

gulp.task('build', () =>
  gulp.src('app.js')
    .pipe(bro({
      transform: [
        babelify.configure({ presets: ['es2015'] }),
        [ 'uglifyify', { global: true } ]
      ]
    }))
    .pipe(gulp.dest('dist')
)

Multiple bundles

gulp.task('build', () =>
  gulp.src('*.js')
    .pipe(bro())
    .pipe(gulp.dest('dist'))
)

API

bro([options], [callback])

options {object}

Except error, options are directly passed to browserify. So you can use bro as if you were using browerify. Here is a list of all available options.

error {'emit'|function}

Another pitfall of using browerify manually was that error reporting had to be done manually too or you ended up with a huge callstack and a crashed process. By default, bro reports nicely formatted errors:

You can customize things in 2 ways:

• Set emit which will cause bro to emit the error, so you can catch it with on('error').
• Set a callback that will handle the error.

FAQ

What is incremental build?

If you use vanilla browserify with gulp, you end up with long compile times if you watch for changes. The reason is that each time a new browserify instance is created and has to parse and compile the whole bundle. Even if only one file has changed, the whole bundle is processed.

Usually you use watchify to improve this, and only recompile files that have changed. The only problem with watchify is that it monitors file changes on its own and needs a lot of boilerplate to integrate with gulp, precisely because of this.

gulp already provide a file watch mechanism that we can use out of the box. bro caches already compiled files and only recompile changes. So you can call repeatedly bro with optimal compile times.

Contributors

^{Generated with contributors-faces.}

License

MIT © Nicolas Gryman