feature_flag_gatekeeper

What problem does it solve?

Enforces gating of expensive or risky features behind a remote switch to prevent unintended live releases.

Core Features & Use Cases

• Flag Definition: Check supabase/migrations/*_feature_flags.sql for existing keys, and if new, add an INSERT to the seed file; default enabled to FALSE.
• Implementation Pattern: Use a reusable guard with a checkFlag wrapper to ensure expensive logic only runs when the flag is enabled, otherwise fall back to a safe path.
• The "Billing Lock": If a feature costs money, the flag config must support a provider switch to toggle between paid and free paths.
• Verification: Validate the fallback path by ensuring the app runs without an API key or external dependency when the flag is off.

Quick Start

Wrap external API usage with a feature-flag check to gate expensive logic behind a remote toggle.