nyc-bookstores/node_modules/beefy/README.md
2013-05-27 13:45:59 -07:00

2.2 KiB

beefy

a local development server designed to work with browserify.

it:

  • can live relaod your browser when your code changes (if you want)
  • works with whatever version of browserify; globally installed or locally installed to node_modules/browserify.
  • will spit compile errors out into the browser so you don't have that 1-2 seconds of cognitive dissonance and profound ennui that follows refreshing the page only to get a blank screen.
  • will spit out a default index.html for missing routes so you don't need to even muck about with HTML to get started
  • serves up static files with grace and aplomb (and also appropriate mimetypes)
  • makes it easy to sanity check your testling ci tape test suite.
  • loves you, unconditionally

how do I get it?

npm install -g beefy; and if you want to always have a browserify available for beefy to use, npm install -g browserify.

usage

$ cd directory/you/want/served
$ beefy path/to/thing/you/want/browserified.js PORT -- [browserify args]

path/to/file.js

the path to the file you want browserified. can be just a normal node module. you can also alias it: path/to/file.js:bundle.js if you want -- so all requests to bundle.js will browserify path/to/file.js. this is helpful for when you're writing gh-pages-style sites that already have an index.html, and expect the bundle to be pregenerated and available at a certain path.

--browserify command

use command instead of browserify or ./node_modules/.bin/browserify.

in theory, you could even get this working with r.js, but that would probably be scary and bats would fly out of it. but it's there if you need it!

--live

enable live reloading. this'll start up a sideband server and an fs watch on the current working directory -- if you save a file, your browser will refresh.

the fake index

by default, if you get a URL that doesn't exist (with an Accept header that has html in it someplace), you'll get the "fake index." this page is setup so that it automatically includes both the live reload script (if it's enabled) and the path you want browserified.

license

MIT