node package manager

Introducing npm Enterprise add-ons. Integrate third-party dev tools into npm…


Temper compiles template for client and server side usage.


Temper is a small module that compiles your templates for server-side usage and client-side usage through one single interface. This makes it easy to create isomorphic JavaScript applications, which is awesome.

The following template engines are supported:

  • react-jsx, automatically discovered by using the .jsx extension.
  • jade, automatically discovered by using the .jade extension.
  • ejs, automatically discovered by using the .ejs extension.
  • hogan.js, automatically discovered by using the .mustache extension.
  • mustache, automatically discovered by using the .mustache extension.
  • handlebars, automatically discovered by using the .mustache extension.
  • html, automatically discovered by using the .html extension.

As you can see from the list above, we support multiple version engines for the mustache extension. You can supply your preference through the API. If no preference is given it will iterate over the template engines and the one that is successfully required will be used automatically.

Temper is distributed through npm:

npm install --save temper

Temper doesn't depend on any template engines so you need to install these your self. For these examples I'm going to assume that you have jade installed as template engine. Run npm install --save jade if this is not the case.

Initialising temper is quite simple:

'use strict';
var Temper = require('temper')
  , temper = new Temper();

The Temper constructor allows the following options:

  • cache should we cache the compiled template, this defaults to true if NODE_ENV is set to production. You usually want to have this disabled during development so you can see the changes in your template without having to restart your node process.

The following methods can be used to interact with temper:

The temper.fetch method allows you to pre-compile your template file. This is advised as requiring modules and reading files is done synchronous. Simply call this method with a file location and an option engine argument.

Temper will try it's best to automatically discover template engines based on file extensions, but sometimes this is impossible. There are tons of mustache compatible template engines and we cannot figure out which one you want based on the extension. But for template languages such as jade it's quite simple.

var data = temper.prefetch('/file/path/to/template.jade');
var data = temper.prefetch('/file/path/to/template.mustache', 'hogan.js');

The fetch method returns an JavaScript object that contains the following properties:

This is an optional property. Some of the supported engines require a helper library to be included at the client-side. If this property is not empty you should include this string together with your client side template on your page.
The client-side compatible version of your given template. This is already converted to a string for your convenience.
The server-side compatible version of your given template. It's a function that's ready to be used.
The name of the template engine that was used to compile your template.
An object that contains the hashes for the library, client and server.

The resulting compiled template have a uniform interface. It's a function that accepts the template data as first argument and returns the generated template.

var template = temper.fetch('/file/path/to/template.jade')
  , html = template({ foo: 'bar' });