hercules

Makes CommonJS packages usable in the browser.

npm install hercules
6 downloads in the last month

Hercules

By mimicking node.js' require, Herluces lets you use your CommonJS packages in the browser. It even supports packages.json dependencies.

This enables you to develop and test your code server side, and bundle it for the browser later.

How does it work?

Hercules = require 'hercules'
bundle = Hercules.bundle '/path/to/my/package'
source = bundle.toString() # Returns a chunk of Javascript that defines this.require

Send source to the browser (for example via express). All code run after source, will have access to a require method.

If you don't want to attach require to window you can do like this:

Hercules = require 'hercules'
bundle = Hercules.bundle '/path/to/my/package'
source = "
  (function() {
    #{bundle.toString()}
    window.MyAwesomeApp = require('.');
  })(window);
"

Installation

Add hercules to your package.json and run npm install. Then you'll be able to do require 'hercules'.

Dependencies

Hercules automatically add dependencies defined in your package.json (read more about package.json).

If you try to bundle a package that depends on a package that require node (defined in package.json's engines field), Hercules will throw an error. If you instead want Hercules to just ignore these packages, you can use ignore_node_packages like this:

Hercules = require 'hercules'
bundle = Hercules.bundle '/path/to/my/package', ignore_node_packages: true
source = bundle.toString()

Alternatives

Here's a list of other libraries that somehow enables you to use require in the browser.

Stitch

Very elegant and simple! Unfortunately, it is based on load paths which makes its require behaves different from node's. Written by one of my heroes, Sam Stephenson.

Browserify

Mature solution with a lot of options and features. It doesn't handle dependencies however. It tries to do too many different things for my taste - but you might see this as an advantage.

Other alternatives I haven't tried:

npm loves you