# gulp-bro
> gulp + browserify + incremental build, done right.
Latest version **2.0.0** (published 2019-11-03) · MIT license · 0 weekly downloads
## Install
```sh
npm install gulp-bro
pnpm add gulp-bro
yarn add gulp-bro
bun add gulp-bro
```
## Health
**Score 15/100 (F)** — status: abandoned.
Positive: no vulnerabilities.
Warnings: low downloads; no types; no esm support.
Negative: abandoned; low maintenance score.
## Facts
| | |
|---|---|
| Version | 2.0.0 |
| Published | 2019-11-03 |
| First published | 2016-02-25 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 6 |
| Unpacked size | 10.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 123 |
| Author | Nicolas Gryman |
| Maintainers | ngryman |
| Keywords | browserify, gulp, recipe, simple, stream, task, watchify |
## Links
- npm: https://www.npmjs.com/package/gulp-bro
- Repository: https://github.com/ngryman/gulp-bro
- npm.io page: https://npm.io/package/gulp-bro
## Dependencies (6)
- [through2](https://npm.io/package/through2.md) ^3.0.1
- [fancy-log](https://npm.io/package/fancy-log.md) ^1.3.3
- [browserify](https://npm.io/package/browserify.md) ^16.5.0
- [ansi-colors](https://npm.io/package/ansi-colors.md) ^4.1.1
- [concat-stream](https://npm.io/package/concat-stream.md) ^2.0.0
- [browserify-incremental](https://npm.io/package/browserify-incremental.md) ^3.1.1
## Alternatives
- [@opentelemetry/exporter-zipkin](https://npm.io/package/@opentelemetry/exporter-zipkin.md) — 14.8M weekly downloads
- [pusher-js](https://npm.io/package/pusher-js.md) — 2.0M weekly downloads
- [browserify](https://npm.io/package/browserify.md) — 1.7M weekly downloads
- [sqs-consumer](https://npm.io/package/sqs-consumer.md) — 1.7M weekly downloads
- [@sanity/eventsource](https://npm.io/package/@sanity/eventsource.md) — 930.8K weekly downloads
## Recent versions
- 2.0.0 (latest) — 2019-11-03
- 1.0.3 — 2018-01-16
- 1.0.2 — 2017-02-19
- 1.0.1 — 2017-01-25
- 1.0.0 — 2017-01-21
- 0.3.2 — 2017-01-21
- 0.3.1 — 2016-10-03
- 0.3.0 — 2016-08-16
- 0.2.2 — 2016-05-05
- 0.2.0 — 2016-02-28
- 0.1.0 — 2016-02-26
- 0.0.0 — 2016-02-25
## README
gulp + browserify + incremental build, done right.
---
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.
[recipes]: https://github.com/gulpjs/gulp/tree/master/docs/recipes
[incremental build]: https://github.com/jsdf/browserify-incremental
## Install
```bash
npm install --save-dev gulp-bro
```
## Usage
### Simple build
```javascript
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
```javascript
gulp.task('build', () =>
gulp.src('app.js')
.pipe(bro({
transform: [
babelify.configure({ presets: ['es2015'] }),
[ 'uglifyify', { global: true } ]
]
}))
.pipe(gulp.dest('dist')
)
```
### Multiple bundles
```javascript
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](https://github.com/substack/node-browserify#browserifyfiles--opts).
#### `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
[//]: contributor-faces
[//]: contributor-faces
Generated with [contributors-faces](https://github.com/ngryman/contributor-faces).
## License
MIT © [Nicolas Gryman](http://ngryman.sh)
---
_Source: https://npm.io/package/gulp-bro · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._