budo

budō

This is a browserify development server inspired by beefy and wzrd, but specifically focused on incremental reloading and LiveReload integration (including CSS injection).

Note that budo needs a copy of watchify installed. It can be either local (preferred) or global.

npm install budo watchify -g

The simplest use cases will start up a server with a default index.html and incrementally bundle your source on filesave. The requests are delayed until the bundle has finished, so you aren't served stale or empty bundles. Examples:

#run watchify on port 9966
budo index.js

#run watchify with timing information
budo index.js --verbose

#run watchify with some options and trigger LiveReload on JS/HTML/CSS file change
budo index.js --live --transform brfs

You can open localhost:9966 to see the content in action.

To pretty-print in terminal, garnish, bistre or another ndjson-based stream can be used.

budo index.js | garnish

See docs for more features.

PRs/suggestions/comments welcome.

docs

• basic usage
• comparisons
• programmatic usage (Gulp, Grunt)
• error reporting
• running tests and examples
• script injection with budo-chrome
• rapid prototyping with budō and wzrd

usage

CLI

Details for budo command-line interface. Other options like --verbose and --transform are sent to browserify/watchify.

Usage:
    budo [entries] [opts]

Options:
    --help, -h      show help message
    --port          the port to run, default 9966
    --host          the host, default "localhost"
    --dir           the directory to serve, and the base for --outfile
    --live          enable LiveReload integration with a script tag
    --live-plugin   enable LiveReload for use with a browser plugin
    --live-port     the LiveReload port, default 35729

By default, the --debug option will be sent to watchify (for source maps). If this is unwanted, you can use --no-debug or --debug=false to disable source maps.

API

The API mirrors the CLI except you must provide a stream for logging, and it does not attempt to auto-portfind.

var budo = require('budo')

budo('./src/index.js', {
  live: true,             //live reload
  stream: process.stdout, //log to stdout
  port: 8000              //use this port
}).on('connnect', function(ev) {
  //...
})

See API usage for more details.

Script Injection

^{(click for demo)}

The original motivation for making budō was to build a simple tool around Chrome Script Injection. This has since split off into its own repository: budo-chrome to minimize the scope of budō.

License

MIT, see LICENSE.md for details.