featurevisor
Feature management for developers
Website | Documentation | Issues | Contributing | Changelog
What is Featurevisor?
Featurevisor is a solution for managing your feature flags, experiments, and remote config. It's built for developers, by developers.
Workflow can be broken down into 3 steps:
- 1️⃣ Manage feature flags, experiments, and remote config in your Git repository
- 2️⃣ Trigger CI/CD pipeline to generate and upload datafiles (static JSON files) to your CDN
- 3️⃣ Fetch and evaluate datafiles in your applications using Featurevisor SDKs
More documentation available at https://featurevisor.com.
Supported features:
- 🚩 Feature flags: classic on/off switches
- 🆎 Experimentation: a/b and multivariate tests
- 👥 Segmentation: reusable conditions for targeting groups of users
- ↗️ Gradual rollouts: avoid big bang releases, and go from 0% to 100% rollout gradually
- 🔧 Variables: store key/value pairs for remote config namespaced under each feature
- 🎯 Consistent bucketing: makes sure same user gets same variation across devices/sessions
- 🌏 Multiple environments: Go beyond just staging and production to fit your needs
- 🏷️ Tagging: Load only features relevant to your application, avoiding bloat
- 👁️ Tracking: Track experiment activations with your favourite analytics tool
SDK support:
- JavaScript (both Node.js and browser environments)
- Swift
- React
- Vue.js
Swift and Kotlin SDKs are coming soon for native apps.
Quick start
You are recommended to see a more detailed quick start guide here: https://featurevisor.com/docs/quick-start/.
The whole process can be broken down into 3 steps:
Step 1: Create a Featurevisor project
Use npx to scaffold a new Featurevisor project:
$ mkdir my-featurevisor-project && cd my-featurevisor-project
$ npx @featurevisor/cli init
$ npm installYou can now create and manage your feature flags, experiments, and remote config in this directory expressed as YAMLs.
See the building block guides here:
- Attributes: building block for conditions
- Segments: conditions for targeting users
- Features: feature flags and variables with rollout rules
Step 2: Build and deploy datafiles
Once the project is ready, you can build your datafiles (JSON files containing configuration of your feature flags):
$ npx featurevisor buildYou will find the output in dist directory, that you can upload to your CDN.
See further guides here:
- Building datafiles: how to build datafiles
- Deploying datafiles: how to deploy datafiles to your CDN
A fully functioning example for deploying with Cloudflare and GitHub Actions (for free) is available here.
Step 3: Consume datafiles with Featurevisor SDKs
You can now consume the datafiles from your CDN in your applications directly using Featurevisor SDKs.
For Node.js and browser environments, install the JavaScript SDK:
$ npm install --save @featurevisor/sdkNow you can initialize the SDK with the URL of your datafile, and evaluate your feature flags:
import { createInstance } from "@featurevisor/sdk";
// Initialize the SDK
const f = createInstance({
datafileUrl: "https://cdn.yoursite.com/datafile.json",
onReady: () => console.log("Datafile has been fetched and SDK is ready"),
});
// Evaluate a feature flag
const featureKey = "myFeature";
const context = {
userId: "user-123",
country: "nl",
};
const isEnabled = f.isEnabled(featureKey, context);
const variation = f.getVariation(featureKey, context);
const variable = f.getVariable(featureKey, "someVariableKey", context);Learn more about SDK usage here: https://featurevisor.com/docs/sdks/.
Packages
| Package | Version | Description |
|---|---|---|
| @featurevisor/cli | |
CLI package |
| @featurevisor/core |  |
Core package used by CLI |
| @featurevisor/react |  |
React package |
| @featurevisor/sdk |  |
Universal SDK for both Node.js and browser |
| @featurevisor/site |  |
Static site generator for your project |
| @featurevisor/types |  |
Common typings |
| @featurevisor/vue |  |
Vue.js package |
License
MIT © Fahad Heylaal