node package manager

expressive

Adds environment-specific hooks to express apps

Expressive

npm install --save expressive

var express = require('express');
var app = express();
var expressive = require('expressive');
 
// nconf setup not pictured 
expressive(app, nconf.get('NODE_ENV')).env('development');
 
app.use('/normal-route', function(req, res, next) {
  next();
});
 
app.development.get('/dev-only-route', function(req, res, next) {
  next();
});

Expressive installs environment-specific hooks in your express app, which essentially eliminates the need to do something like

if (process.env.NODE_ENV === 'development') {
  app.use(/* some dev route */)
}

Of course, you could just use if statements like this, but I've found that expressive makes an app easier to read because all the route definitions are parallel. Additionally, testing is slightly easier because you don't have to specify a describe for each environment. You can just assert that app.environmentName exists and, if you're into this kind of thing, that it gets called with the appropriate routes and handlers.

Expressive exports a single function that takes two arguments: your express app and, optionally, the current environment (defaulting to process.env.NODE_ENV). It returns an object with a single method: .env.

expressive(app)

or

expressive(app, currentEnvironment)

The .env method also takes two arguments: the name of the environment to add hooks for and an optional alias for that environment. This method returns the same object (this) so you can chain your .env calls.

var express = require('express');
var app = express();
var expressive = require('expressive');
 
expressive(app)
  .env('test')
  .env('smoktest')
  .env('development', 'dev') // Alias "dev" allows you to do app.dev.use instead of app.development.use

Please see the contribution guidelines.