#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

#Changelog

Please see CHANGELOG for more information on what has changed recently.

#Security Vulnerabilities

Please see SECURITY for details.

#Credits

• Jefferson Gonçalves

#License

MIT License. See LICENSE for details.