Skip to content
Docs navigationBrowse tools →

Tool docs

Feature Flag Simulator

Simulate one user against one feature flag to inspect rule order, rollout bucketing, variant assignment, and fallback behavior before you ship a release.

Tool

Overview

01

Feature Flag Simulator

Use the simulator to answer a very specific release question: why did this user match, miss, or fall through a flag? Birdor evaluates the same config locally and shows the trace, bucket, and final value without talking to any remote flag platform.

Model

What it models

01

Single flag, single user, first-match-wins

  • Ordered rules with AND conditions inside each rule
  • Stable rollout bucketing using a deterministic hash
  • Boolean flags and weighted variant experiments
  • Fallback behavior when no rule matches

Explainability

Trace and bucket output

01

See why the result happened

The trace panel shows which conditions passed or failed, whether rollout allowed the user through, and which rule served the final value. The bucket panel shows the hash input, hex digest, bucket number, and variant range when a variant experiment is in play.

Workflow

Simulation mode

01

Patch inputs without touching the baseline

The what-if panel lets you change user id, environment, rollout percentage, and salt locally. Birdor recomputes a second evaluation result so you can compare before and after without rewriting the base config.