A feature flag library which runs fully on the service itself, without any dependencies.
npm install toggle-kitA customizable feature flag library, which allows you to define properties and flags. Everything runs "locally" on the service (application or API), without any dependencies.
- Table of contents
- Getting Started
- Installation
- Usage
- Setting up feature flag client
- Add properties to client
- Create feature flag
- Evaluate feature flag
- Contributing
- Credits
- Built With
- Versioning
- Authors
- License
These instructions will help you install the package itself and set the library up. It's gonna guide you through how to add properties, and how to create flags with different conditions.
This project requires NodeJS (version 20 or later) and NPM. Node and NPM are really easy to install. To make sure you have them available on your machine, try running the following command.
``shell`
$ npm -v && node -v
10.x.x
v20.x.x
To install the package using NPM, PNPM or yarn, run:
`shell`
$ npm install toggle-kit
$ pnpm install toggle-kit
$ yarn install toggle-kit
First of all we want to create an instance of the feature flag client. We can do this by using the createFeatureFlagClient method, which is gonna return an instance of the feature flag class.
`ts
import { createFeatureFlagClient } from "toggle-kit";
const client = createFeatureFlagClient({
property: {
// TODO: Add properties
},
flags: [
// TODO: Create flags
],
});
`
Secondly we want add some attributes we can use in the condition(s) in each of the feature flags we are creating later. You are allowed to use string, number or boolean types as a property
`ts
import { createFeatureFlagClient } from "toggle-kit";
const client = createFeatureFlagClient({
property: {
userId: "eb10e5c2-e3f4-46fc-a6fd-f2ddba0973fb",
email: "example@mail.com",
age: 21,
isAdmin: false,
},
flags: [
// TODO: Create flags
],
});
`
Last but not least, we want to create our first flag. Here we specify a name for the feature flag and select the type of condition(s) we want to evaluate upon. Then we select the property we want to evaluate, and an expected value.
`ts
import { createFeatureFlagClient } from "toggle-kit";
const client = createFeatureFlagClient({
property: {
userId: "eb10e5c2-e3f4-46fc-a6fd-f2ddba0973fb",
email: "example@mail.com",
age: 21,
isAdmin: false,
},
flags: [
{
name: "secret-page",
conditions: [
{
type: "equal",
attribute: "email",
expectedValue: "test@example.com",
},
],
},
],
});
`
When you have finished setting up the feature flag client, and created your flags, you start evaluating flags across your codebase.
`ts
import { createFeatureFlagClient } from "toggle-kit";
const client = createFeatureFlagClient({
property: {
userId: "eb10e5c2-e3f4-46fc-a6fd-f2ddba0973fb",
email: "example@mail.com",
age: 21,
isAdmin: false,
},
flags: [
{
name: "secret-page",
conditions: [
{
type: "equal",
attribute: "email",
expectedValue: "test@example.com",
},
],
},
],
});
const allowSecretPage = client.isEnabled("secret-page");
console.log(allowSecretPage); // False
`
If the getting started examples isn't enough, you can read more in depth documentation here.
Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.
1. Fork it!
2. Create your feature branch: git checkout -b my-new-feature
3. Add your changes:
4. Commit your changes:
5. Push to the branch:
6. Submit a pull request 😎
This package only allows the conventional commits on commit messages. This allows semantic-release to analyze the commits. The commit message should be structured as follows:
`
[optional body]
[optional footer(s)]
`
The common types can be: build, chore, ci, docs, feat, fix, perf, refactor, revert, style, test`
- Readme template @andreasonny83
- Library structure inspiration @trustpilot/skift
- TypeScript
- Jest
- Love ❤️
We use SemVer for versioning. For the versions available, see the tags on this repository.
Fredrik Johansen - Initial work - fredrikj31
See also the list of contributors who participated in this project.
MIT License (c) Fredrik Johansen and Contributors