laravel-feature-flags

Agnostic, DB-backed feature flags for Laravel. Global toggles, per-scope overrides, time windows, dev markers, middleware guard, and a zero-build Blade admin page with dark mode.

Drop it in any Laravel app. No vendor lock-in, no opinionated stack, no assumptions about your domain.

Highlights

• Agnostic: a scope is whatever you want (team, org, region, cohort, user) via a FeatureScopeResolver contract
• Per-scope overrides: scoped row beats global; null scope = global default
• Time windows: enabled_from / enabled_until gating
• Dev marker: is_dev flag for filtering in non-prod environments
• Type-safe keys: enum-based FeatureKey contract
• Facade + middleware: FeatureFlag::isEnabled(...) and the feature.enabled route guard
• Admin UI: published Blade page with toggle switches, inline edits, dark mode, scope grouping
• Repository pattern: swap EloquentFeatureFlagRepository for any backend

Install

composer require chemaclass/laravel-feature-flags
php artisan vendor:publish --tag=feature-flags
php artisan migrate

The single feature-flags tag publishes the config, the migration, the admin view, and the admin routes file. See docs/installation.md for per-tag installs.

30-second usage

use Chemaclass\FeatureFlags\Contracts\FeatureKey;
use Chemaclass\FeatureFlags\Facades\FeatureFlag;

enum AppFeature: string implements FeatureKey
{
    case NewDashboard = 'new-dashboard';

    public function key(): string { return $this->value; }
}

// Global check
if (FeatureFlag::isEnabled(AppFeature::NewDashboard)) {
    // gated code
}

// Scoped check. $scopeId is whatever string your app decides on
// (team id, organization id, region code, cohort name, etc.)
if (FeatureFlag::isEnabled(AppFeature::NewDashboard, $scopeId)) {
    // gated code
}

Full API on the facade: isEnabled, all, create, update, updateOrCreate, delete, toggleValue, toggleDevByKey, findById, findByKeyAndScope. See docs/usage.md.

Route guard:

use Chemaclass\FeatureFlags\Http\Middleware\EnsureFeatureIsActive;

Route::get('/dashboard', DashboardController::class)
    ->middleware(EnsureFeatureIsActive::using(AppFeature::NewDashboard));

// or via alias
Route::get('/dashboard', DashboardController::class)
    ->middleware('feature.enabled:new-dashboard');

Admin UI

Visit /admin/feature-flags (configurable, gated by web+auth by default). Features:

• Flags grouped by key, global row tinted, scope overrides nested
• Real sliding toggle switches, inline hint and time-window editing
• Per-row and per-key dev marker toggles
• Add scope override / new flag forms
• Dark mode toggle, default follows OS
• Color-hashed scope badges

See docs/admin-ui.md.

Documentation

Publish tags

Requirements

• PHP ^8.3
• Laravel ^11.0 || ^12.0

Contributing

See CONTRIBUTING.md for local dev setup, the Docker demo app, the test suites, formatting, and the release.sh flow.

License

MIT.