kraken-feature-flagger

kraken-feature-flagger
===

Feature flags for Kraken JS apps.

Install

Required: nodejs (tested against v0.10 and 0.12), or io.js (tested against v1.4.2), npm.
``npm install kraken-feature-flagger --save`

Usage

$3

In your config/config.json file, add a features section and some features. Set each feature to true or false to enable/disable:
`json
{
"features": {
"happy": true,
"awesome": true,
"deprecated-feature": false
},
...
}
`

$3

Create a kraken app as usual, and add the middleware to your app or an Express router/route.
`javascript
var kraken = require('kraken-js'),
app = module.exports = require('express')(),
features = require('kraken-feature-flagger'),
options = {};

app.on('start', function () {
console.log('app started and ready to serve requests.');
});

app.use(kraken(options));
//set features flag middleware here,
//or in your routers
app.use(features());
`

$3

In a route, your enabled features will be available on req.features:
`javascript
module.exports = function (router) {
router.get('/', function (req, res) {
console.log(req.features.enabled); // => ['happy', 'awesome']
if (req.features.has('awesome')) {
res.render('awesome');
} else {
res.render('sadtrombone');
}
});
}
`

$3

You can set feature classes in your views as well, as res.locals.featureClasses is created for you:
`html
...
`
returns
`html
...
`

$3

You can also "gate off" routes, which means that route is only available if your config enables it. Otherwise users will see a 503 Service Unavailable error. Here's an example:
`javascript
var gate = require('kraken-feature-flagger/gate');

router.get('/gated', gate('awesome-people-only'), function (req, res) {
res.send('You must be awesome since they let you in here!');
});
``