README

Filament Panel Theme Isolation

Isolates dark/light theme preference per Filament panel using prefixed localStorage keys.

When a Filament application has multiple panels (e.g., admin, app, tenant), they all share the same theme key in localStorage. Switching dark/light mode in one panel affects all others. This plugin fixes that by using panel-specific keys like theme-admin, theme-app, etc.

Based on filamentphp/filament#19417.

Compatibility

Installation

You can install the package via composer:

composer require jeffersongoncalves/filament-panel-theme-isolation:"^3.0"

That's it! The plugin works automatically via Laravel auto-discovery. No additional configuration is needed.

Optional: Register as a Filament Plugin

If you prefer explicit registration via the plugin API:

use JeffersonGoncalves\FilamentPanelThemeIsolation\FilamentPanelThemeIsolationPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->id('admin')
        ->plugin(FilamentPanelThemeIsolationPlugin::make());
}

How It Works

1. Each panel saves its theme preference to a unique localStorage key: theme-{panelId} (e.g., theme-admin, theme-app).
2. On first load after installing, the existing generic theme key is automatically migrated to the panel-specific key.
3. If the panel-specific key doesn't exist, it falls back to the generic theme key for backwards compatibility.
4. No database or session changes required — everything is localStorage.

Publishing

Config

php artisan vendor:publish --tag=filament-panel-theme-isolation-config

Views

php artisan vendor:publish --tag=filament-panel-theme-isolation-views

Maintenance Notes

The overridden views are copies of Filament's original views with minimal patches.

After updating Filament, compare the original views with the overrides:

diff vendor/filament/filament/packages/panels/resources/views/components/layout/base.blade.php \
     vendor/jeffersongoncalves/filament-panel-theme-isolation/resources/views/components/layout/base.blade.php

License

MIT License. See LICENSE for details.