Feature Flag Demo

Flip app features on and off in real time — no rebuilds, no redeploys.

A small Flutter shopping demo wired with BLoC + Flagsmith (or mock mode if you don’t have an account). Toggle the AI Assistant card and Express Checkout button live from a Dev Settings drawer.

Why this exists

Feature flags let you ship dark and turn features on when you’re ready — for yourself, a beta group, or everyone. This project shows a clean way to do that in Flutter:

Repo → BLoC → UI

Remote (or mock) flags flow into state, and the UI reacts. Reviewers can override anything locally without touching Flagsmith.

Run it

flutter pub get
flutter run

No API key needed. Mock mode uses sensible defaults (AI Assistant on, Express Checkout off).

Open the tune icon → flip flags, try light/dark theme, you’re done.

Optional: real Flagsmith

1. Create an environment and add:
   • is_ai_assistant_enabled
   • is_express_checkout_enabled
2. Run with your key:

flutter run --dart-define=FLAGSMITH_API_KEY=your_env_key

What’s inside

Piece	Role
FeatureFlagRepository	Flagsmith + offline fallback + local overrides
FeatureFlagBloc	Loads flags and pushes updates to the UI
Home + Dev Settings	Conditionally renders features; instant overrides
Light / dark theme	Tiny theme layer with a System / Light / Dark toggle

flutter test

That’s it — keep it running, flip a switch, watch the UI change.