browserify-rails

Build Status

This library adds CommonJS module support to Sprockets (via Browserify).

It let's you mix and match //= require directives and require() calls for including plain javascript files as well as modules.

  1. Manage JS modules with npm
  2. Serve assets with Sprockets
  3. Require modules with require() (without separate //= require directives)
  4. Only build required modules
  5. Require npm modules in your Rails assets

Getting Started

Add this line to your application's Gemfile:

gem "hsume2-browserify-rails", "~> 0.2.0", :require => "browserify-rails"

Create package.json in your Rails root:

{
  "name": "something",
  "devDependencies" : {
    "browserify": "~> 3.33"
  },
  "license": "MIT",
  "engines": {
    "node": ">= 0.6"
  }
}

[TODO: Write a Rails generator for this]

Then run:

npm install

Then start writing CommonJS, and everything will magically work!:

// foo.js
module.exports = function (n) { return n * 11 }

// application.js
var foo = require('./foo');
console.log(foo(12));

Coffeescript

Coffeescript is handled seamlessly, if you name your files *.js.coffee. That way the coffeescript compiler will already have done it's work, when we are putting the javascript tools to work.

Contributing

Pull requests appreciated.

Contributors