node package manager


Unframework for node.js web application

Ute is an unframework for simple node.js web application.

This is handy if you want to run your web app by specifying route + environment configuration files and handler functions, with less repetitive boilerplate code.

Under the hood, Ute uses Express, EJS (with Partials), and nconf.

npm install ute

or as a dependency in package.json file:

"dependencies": {
  "ute": "x.y.z"

Specify handler functions:

function homeCb(req, res) {
  res.render('home.html', {
    layout: 'mylayout',
    locals: {
      name: 'Bob'

function dataCb(req, res) {
  res.json({ foo: 'bar' });

Create a Ute instance and call start:

var Ute = require('ute');
var ute = new Ute();

var handlers = { home: homeCb, data: dataCb }


Place mylayout.html and home.html under views directory:


<head><title>My Site</title></head>
  <%- body %>


Hello <%= name %>!

Set application name and port in conf/.json:

  "app": {
    "name": "myapp",
    "port": 9000

Set log4js configuration in conf/-log4js.json, e.g.

  "appenders": [
      "type": "console"
      "type": "file",
      "filename": "someapp.log",
      "maxLogSize": 10240000,
      "backups": 10
  "replaceConsole": true

Set routes path and handler mappings in conf/routes.json:

  { "method": "GET", "path": "/", "handler": "home" },
  { "method": "POST", "path": "/data", "handler": "data" }

Developer's Guide

Build reports: