Set up FlagSync

The guide below will walk you through creating and configuring your first feature flag.

1. Create a project

Start your free 14 day trial at https://www.flagsync.com/register. No credit card required.

2. Create a feature flag

Design your first flag at https://www.flagsync.com/dashboard/flags

  1. Enter a flag key: This is a unique identifier for the flag, and will be used in code to retrieve the flag value. It cannot be changed once set.

  2. Enter a name: This is a human-readable name for the flag. It can be changed after creation.

  3. Enter a description: Optionally describe the functionality of the flag.

  4. Choose flag type: The flag type controls the data type of variant values. See below:

Boolean

Ideal for simple on/off or true/false feature toggles. Use this for features that you want to either enable or disable entirely without additional complexity.

String

Perfect for selecting between multiple predefined options. This type can be used for features that change behavior or appearance based on a set of known values, such as theme options ("light", "dark"), or copy ("Join Now", "Register", "Sign Up")

Number

Suitable for features that require numeric values for configuration. This could include thresholds, limits, or other quantifiable parameters that your application needs to function dynamically.

JSON

Provides the utmost flexibility by allowing you to define complex configurations within a single flag

  1. Define flag variants: Define the variants that will be served for this feature flag.

3. Configure targeting

Default Targeting

With every flag, you're able to define the default enabled variant, and default disabled variant.

The former is served to all users when the flag is enabled, whereas the latter is served to all users when the flag is disabled.

Individual Targeting

With every flag, you're able to define rules to target specific user segments that you define with custom attributes, such as "QA Tester" or "Product Team". Or, you can target specific users by email or user key.

A use case would be to target "QA Testers" for a feature under test, while all other users are served the baseline variant (i.e. existing experience).

Percentage Rollouts

FlagSync offers dead-simple distributed rollouts. Simply define the percentages that should be served for each variant, and save the flag.

Users are bucketed deterministically and will be consistently served the same flag variant, ensuring the same experience for the duration of the rollout.

4. Toggle the flag

Simply toggle the flag, and you're good to go!

5. Get your flags in code

Head over to the SDK quickstart guide to start evaluating your flags in code

JavaScript

Last updated