Skip to main content

Quickstart

You will have a live feature flag in under 5 minutes. The first four steps are all in the dashboard. You only need a terminal for the last step, where you call the evaluate endpoint from your application.

1. Create an account​

Go to ffs.adarshrust.com and click Get started free. Enter your email and a password, then click Create account. You land on the dashboard immediately.

Already have an account? Click Sign in instead.

2. Create a project​

A project represents one of your applications. On the dashboard you will see an inline form — type a name (for example, My App) and click New project. Your project card appears in the list.

Click the card to open it.

3. Copy your SDK key​

The project page shows a panel labelled SDK Key at the top. This is the key your application will send when calling the evaluate endpoint. Click Copy to copy it — keep it handy for step 5.

Your project comes with two environments pre-created: Production and Staging. Both use the same SDK key.

4. Create and enable a flag​

Click Production to open the production environment. You will see an empty flag list and a form at the top.

Enter a Flag name (for example, Dark Mode) and a Key (for example, dark_mode) and click Add flag. The flag appears in the list, toggled off.

Click the toggle next to it to enable the flag.

5. Evaluate the flag from your app​

Your flag is live. Call the evaluate endpoint from your application, passing the SDK key and a user context:

curl -X POST https://api.ffs.adarshrust.com/sdk/v1/evaluate \
  -H "X-SDK-Key: YOUR_SDK_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "environment": "production",
    "context": {
      "user_id": "user_123",
      "user_email": "[email protected]"
    }
  }'

Response:

{
  "flags": {
    "dark_mode": {
      "enabled": true,
      "reason": "Flag enabled globally"
    }
  }
}

In your application code, read flags.<key>.enabled:

const res = await fetch('https://api.ffs.adarshrust.com/sdk/v1/evaluate', {
  method: 'POST',
  headers: {
    'X-SDK-Key': process.env.FFS_SDK_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    environment: 'production',
    context: { user_id: user.id, user_email: user.email },
  }),
});
const { flags } = await res.json();

if (flags['dark_mode']?.enabled) {
  // show dark mode
}

Toggle the flag off in the dashboard and the next evaluate call returns enabled: false. No redeployment needed.

Next steps​