hughsk / node-hbsfy

Handlebars precompiler plugin for Browserify v2.

hbsfy

Handlebars precompiler plugin for Browserify v2 without magic.

Compiles Handlebars templates to plain Javascript. The compiled templates depend only on handlebars-runtime so they are lightweight and fast!

Usage

Install hbsfy locally to your project:

npm install hbsfy

Handlebars runtime will be automatically installed as peer dependency.

Then use it as Browserify transform module with -t:

browserify -t hbsfy main.js > bundle.js

where main.js can be like:

var template = require("./template.hbs");
document.body.innerHTML = template({ name: "Epeli" });

and template.hbs:

<h1>Hello {{name}}!</h1>

Helpers

To register custom helpers just require the runtime use and registerHelper to create helper:

var Handlebars = require("handlebars-runtime");
Handlebars.registerHelper("upcase", function(s) {
  return s.toUpperCase();
});

Partials

Partials can be created by giving precompiled template to the registerPartial function.

Handlebars.registerPartial('link', require("./partial.hbs"));

Checkout the example folder for details.

Browserify?

https://github.com/substack/node-browserify

Further reading: http://esa-matti.suuronen.org/blog/2013/03/22/journey-from-requirejs-to-browserify/