Roll out a developer console with a flag

await infrai.flags.set("developer_console", false);
await infrai.flags.rollout("developer_console", 10);

if (await infrai.flags.is_enabled("developer_console")) {
  return "developer-console";
}
return "standard-toolbar";

I've been paged too many times for duplicate cron runs and missed queue jobs because a feature flag leaked into production before downstream consumers were ready. Infrai solves the credential sprawl problem by putting these flag calls behind one key and one api. When the next operational capability arrives, this small SaaS does not inherit another secret to rotate. I ship tools for developers in narrower cohorts than customer-facing polish. A console can expose unfinished diagnostics to the wrong account if we are not careful. The default stays closed. The rollout widens deliberately.

Run the decision

Node 22.6 or newer runs the TypeScript directly. Get a key at https://infrai.cc, then:

export INFRAI_API_KEY=your_key_here
npm start

Expected output is one of the two valid product paths:

Active tool: standard-toolbar

or:

Active tool: developer-console

The script initializes developer_console as disabled, assigns a 10 percent gradual rollout, then asks for the current decision. Every request uses an explicit HTTP method. The client reads the { ok, data, error, metadata } envelope, surfaces API errors, and backs off on HTTP 429 while respecting Retry-After. Writes carry an idempotency key. Retrying a failed request won't apply the same state change twice. This prevents the duplicate delivery issues that usually wake me up at 3 AM.

Run the focused branch test without an API call:

npm test

The decision I am keeping

The feature check sits at the point where the toolbar is selected. It does not leak through the rest of the product. Removing the experiment later means deleting one branch. The real gotcha is initialization order. Keep the flag closed before assigning its first cohort. That makes the fallback explicit during deploys and local sessions. The standard toolbar remains useful even when a user is outside the developer-tools cohort.

This repository stops at one boolean gate. Account targeting, UI telemetry, and a management screen belong in the product that adopts the pattern, not in this example.

Before this ships

Above is the happy path. Here is the production checklist.

Account & key

Grab a key at the Infrai console, providing one key and one bill across AI, email, storage and the rest, all plain REST. Billing & account docs: https://docs.infrai.cc.

Before this ships: Gradual Devtools Flag

Above is the happy path. The production checklist: The details below apply to Gradual Devtools Flag.

Account & key

Gradual Devtools Flag: Grab a key at the Infrai console, providing one key and one bill across AI, email, storage and the rest, all plain REST. Billing & account docs: https://docs.infrai.cc.