Webapp Feature Flags

Gating Patterns

Backend (Hack):

• Team-level: Toggle\YourToggle::isEnabled($team_id)
• User-level: Toggle\YourToggle::isEnabledForUser($team_id, $user_id)
• Org-level: Check Houston for org-level targeting

Frontend (TypeScript):

• Access via the experiments/feature flag framework in the boot data
• Check existing patterns in js/modern/ for examples

Flag Lifecycle

1. Development: Flag off by default, enabled for dev environments
2. QA: Enabled for QA environments and specific test teams
3. Rollout: Progressive percentage rollout via Houston
4. Cleanup: Remove flag and dead code path after full rollout

Cleanup

Use webapp's existing toggle-cleanup Claude Code plugin for removing fully-rolled-out flags:

/toggle-cleanup <toggle_name>

This removes the toggle checks and dead code paths.

Best Practices

• Name flags descriptively: feature_name_short_description
• Always have a clean off-path (existing behavior) and on-path (new behavior)
• Don't nest feature flags — if feature B depends on feature A, document the dependency
• Add the flag name to your task's Work Summary so reviewers can find it