• Stars
    star
    655
  • Rank 68,765 (Top 2 %)
  • Language
    JavaScript
  • License
    MIT License
  • Created about 11 years ago
  • Updated about 4 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Flexible Feature Flipping/Flagging for Node.js

fflip

Working on an experimental new design? Starting a closed beta? Rolling out a new feature over the next few weeks? Fa-fa-fa-flip it. fflip gives you complete control over releasing new functionality to your users based on their user id, join date, membership status, and whatever else you can think of. fflip's goal is to be the most powerful and extensible feature flipping/toggling module out there.

  • Create custom criteria to segment users & features based on your audience.
  • View & edit feature access in one easy place, and not scattered around your code base.
  • System-Agnostic: Support any database, user representation or web framework you can throw at it.
  • Extensible: Supports 3rd-party plugins for your favorite libraries (like our Express integration!)
npm install fflip --save

Integrations

As mentioned, fflip's goal is to be flexible enough to integrate with any web framework, database, or ORM. The following integrations are known to exist:

If you're interested in creating an integration, don't hesitate to reach out or create an issue if some functionality is missing. And if you've created an integration, please add it to the list above!

Getting Started

Below is a simple example that uses fflip to deliver a closed beta to a fraction of users:

// Include fflip
let fflip = require('fflip');

fflip.config({
  criteria: ExampleCriteria, // defined below
  features: ExampleFeatures  // defined below
});

// Get all of a user's enabled features...
someFreeUser.features = fflip.getFeaturesForUser(someFreeUser);
if(someFreeUser.features.closedBeta === true) {
  console.log('Welcome to the Closed Beta!');
}

// ... or just check this single feature.
if (fflip.isFeatureEnabledForUser('closedBeta', someFreeUser) === true) {
  console.log('Welcome to the Closed Beta!');
}

Criteria

Criteria are the rules that define access to different features. Each criteria takes a user object and some data as arguments, and returns true/false if the user matches that criteria. You will use these criteria to restrict/allow features for different subsets of your userbase.

let ExampleCriteria = [
  {
    id: 'isPaidUser',
    check: function(user, isPaid) {
      return user.isPaid == isPaid;
    }
  },
  {
    id: 'percentageOfUsers',
    check: function(user, percent) {
      return (user.id % 100 < percent * 100);
    }
  },
  {
    id: 'allowUserIDs',
    check: function(user, allowedIDs) {
      return allowedIDs.indexOf(user.id) > -1;
    }
  }
];

Features

Features represent some special behaviors in your application. They also define a set of criteria to test users against for each feature. When you ask fflip if a feature is enabled for some user, it will check that user against each rule/criteria, and return "true" if the user passes.

Features are described in the following way:

let ExampleFeatures = [
  {
    id: 'closedBeta', // required
    // if `criteria` is in an object, ALL criteria in that set must evaluate to true to enable for user
    criteria: {isPaidUser: true, percentageOfUsers: 0.50}
  },
  {
    id: 'newFeatureRollout',
    // if `criteria` is in an array, ANY ONE set of criteria must evaluate to true to enable for user
    criteria: [{isPaidUser: true}, {percentageOfUsers: 0.50}]
  },
  {
    id: 'experimentalFeature',
    name: 'An Experimental Feature', // user-defined properties are optional but can be used to add important metadata on both criteria & features
    description: 'Experimental feature still in development, useful for internal development', // user-defined
    owner: 'Fred K. Schott <[email protected]>', // user-defined
    enabled: false, // sets the feature on or off for all users, required if `criteria` is not present
  },
]

The value present for each rule is passed in as the data argument to it's criteria function. This allows you to write more general, flexible, reusable rules.

Rule sets & lists can be nested and combined. It can help to think of criteria sets as a group of AND operators, and lists as a set of OR operators.

Veto Criteria

If you'd like to allow wider access to your feature while still preventing a specific group of users, you can use the $veto property. If the $veto property is present on a member of a criteria list (array), and that member evaluates to false, the entire list will evaluate to false regardless of it's other members.

{
  // Enabled if user is paid OR in the lucky 50% group of other users currently using a modern browser
  criteria: [{isPaidUser: true}, {percentageOfUsers: 0.50, usingModernBrowser: true}]
  // Enabled if user is paid OR in the lucky 50% group of other users, BUT ONLY if using a modern browser
  criteria: [{isPaidUser: true}, {percentageOfUsers: 0.50}, {usingModernBrowser: true, $veto: true}]
}

Usage

  • .config(options) -> void: Configure fflip (see below)
  • .isFeatureEnabledForUser(featureName, user) -> boolean: Return true/false if featureName is enabled for user
  • .getFeaturesForUser(user) -> Object: Return object of true/false for all features for user
  • .reload() -> void: Force a reload (if loading features dynamically)

Configuration

Configure fflip using any of the following options:

fflip.config({
  criteria: {}, // Criteria Array
  features: {}, // Features Array | Function (see below)
  reload: 30,   // Interval for refreshing features, in seconds
});

Loading Features Dynamically

fflip also accepts functions for loading features. If fflip is passed a function with no arguments it will call the function and accept the return value. To load asynchronously, pass a function that sends a features object to a callback. fflip will receive the callback and set the data accordingly. In both cases, fflip will save the function and call it again every X seconds, as set by the reload parameter.

// Load Criteria Synchronously
let getFeaturesSync = function() {
  let collection = db.collection('features');
  let featuresArr = collection.find().toArray();
  /* Process/Format `featuresArr` if needed (format described above) */
  return featuresArr;
}

// Load Features Asynchronously
let getFeaturesAsync = function(callback) {
  let collection = db.collection('features');
  collection.find().toArray(function(err, featuresArr) {
    /* Handle err
     * Process/Format `featuresArr` if needed (format described above) */
    callback(featuresArr);
  });
}

fflip.config({
  criteria: ExampleCriteriaObject,
  features: getFeaturesAsync, // or: getFeaturesSync
  reload: 60 // update available features every 60 seconds
});

Special Thanks

Original logo designed by Luboลก Volkov

More Repositories

1

snowpack

ESM-powered frontend build tool. Instant, lightweight, unbundled development. โœŒ๏ธ
JavaScript
19,494
star
2

CoVim

Collaborative Editing for Vim
Vim Script
2,945
star
3

pika-pack

๐Ÿ“ฆโšก๏ธ Build your npm package using composable plugins. https://www.pika.dev/blog/introducing-pika-pack/
JavaScript
2,312
star
4

the-node-way

Design patterns and best practices for building scaleable, maintainable and beautiful Node.js applications. Now with website! -->
JavaScript
1,492
star
5

create-snowpack-app

The all-in-one app template for Snowpack. [moved]
JavaScript
728
star
6

esm-hmr

a Hot Module Replacement (HMR) API for your ESM-based dev server.
TypeScript
412
star
7

rollup-plugin-polyfill-node

A modern Node.js polyfill for your Rollup bundle.
TypeScript
174
star
8

pika-pack-builders

๐Ÿ— A collection of official & community @pika/pack build plugins
JavaScript
162
star
9

react

ESM builds of React & React DOM (v16)
JavaScript
53
star
10

standard-pkg

Standard NPM Package Format
TypeScript
42
star
11

analyze-npm

Analyze npm, hunt for es module packages
JavaScript
35
star
12

pika-pack-examples

Example @pika/pack packages & projects
JavaScript
33
star
13

slackey

The simple, easy-to-use JavaScript SDK for Slack
JavaScript
32
star
14

fflip-express

fflip integration for the express.js web framework
JavaScript
16
star
15

dbplace

JavaScript
12
star
16

snowpack-plugin-starter-template

Blank Snowpack plugin template to get up and running fast
TypeScript
6
star
17

headless-garden

TypeScript
3
star
18

middle-man

Simple express middleware manager
JavaScript
3
star
19

ie11-going-away-party

Working title
HTML
1
star