Featurama

Removing the chaos from your features.

Featurama gives you feature flags for enabling front-end features at build-time and run-time, while using the same configuration.

Installation

npm install featurama

Usage

To use build-time featurama:

var featurama = require('featurama')({
      featurePath: '/features',
      root: '/src'
    });

To use run-time featurama:

1. Include featurama-client.js into your client-side javascript build.
2. Set up a build-task that adds the run-time configuration file to your client-side javscript assests (See: featurama.buildRunTimeConfigFile() in the API section below).

Configuration Setup

In /features (or whatever you specified as the featurePath):

module.exports = {
  featureName: 'Feature 1',
  buildTimeEnabled: false,
  runTimeEnabled: function() { return !!Modernizr.history; },
  jsFiles: [
    'feature1.js',
  ],
  vendorFiles: [],
  scssFiles: [
    '_feature1.scss',
  ],
};

API

Run-time Methods

featurama.enabled(featureName)

Given a feature name, this indicates if it is enabled or not.

| Parameter | Type | Description | |---|---|---| | featureName | string | the name of the feature | | Returns: | boolean | true if enabled |

featurama.on(featureName)

Given a feature name, this enables that feature.

| Parameter | Type | Description | |---|---|---| | featureName | string | the name of the feature |

featurama.off(featureName)

Given a feature name, this disables that feature.

| Parameter | Type | Description | |---|---|---| | featureName | string | the name of the feature |

Build-time Methods

featurama.isBuildTimeEnabled(buildTimeEnabled)

Return the boolean value or executes the function that defines if this feature is enabled or not.

| Parameter | Type | Description | |---|---|---| | buildTimeEnabled | boolean | function | data from the config file that indicates enabled status | | Returns: | boolean | true if enabled |

featurama.buildFeatureExclusions

Build a list of files to exclude

| | Type | Description | |---|---|---| | Returns: | object | object of arrays containing files to exclude |

featurama.buildFeatureInclusions()

Build a list of files to include

| | Type | Description | |---|---|---| | Returns: | object | object of arrays containing files to include |

featurama.featureValuesList()

Get a list of all of the declared features, their states, and file lists

| | Type | Description | |---|---|---| | Returns: | object | combined feature configs |

featurama.featureList()

Build a key:value list of features and their enabled states

| | Type | Description | |---|---|---| | Returns: | object | key: value pairs |

featurama.buildRunTimeConfigFile(outputFolder, outputType)

Generates a config file (named runTimeFlags.js) to be included in your client-side code. This file bridges the gap between your featurama configuration and your run-time feature flags.

| Parameter | Type | Description | |---|---|---| | outputFolder | string | path to the folder where you want to generate runTimeFlags.js; example: path/to/my/scripts. | | outputType | string | The type of output ['var', 'ES6'] |