ashrafic/filament-white-label

Filament White-Label

Total panel rebranding. For you and every tenant. No code.

Logo, colors, fonts, layout, CSS, footer — every tenant gets their own brand. Or rebrand your own portal in a single-tenant setup. Install, add one line to your PanelProvider, done.

Installation

composer require ashrafic/filament-white-label
php artisan white-label:install
php artisan migrate

Panel Registration

Two pieces — both required for the settings page to appear:

use FilamentWhiteLabel\Resources\WhiteLabelSettingsResource;

$panel
    ->whiteLabel()                                      // wires up branding
    ->resources([
        WhiteLabelSettingsResource::class,              // adds the nav item
    ]);

• ->whiteLabel() enables white-label functionality across the panel
• WhiteLabelSettingsResource registers the settings page — without it, no nav item appears

A White Label nav item appears with three sub-pages: Brand, Layout, Advanced.

Tenant Model Setup (Optional)

Add the HasWhiteLabel trait to your tenant model only if you want default settings eagerly created when a new tenant is created:

use FilamentWhiteLabel\Traits\HasWhiteLabel;

class Team extends Model
{
    use HasWhiteLabel;
}

The trait hooks into the created event to auto-create a default settings record.

Without the trait, defaults are created lazily — only when the White Label page is first visited. Skip this step for single-tenant setups, or if you don't need the settings row to exist before page visit.

Guides

Full docs at docs.ashraficlabs.com/filament-white-label

Screenshots

Brand Identity	Colors

Typography, Styling & Custom CSS	Layout: Navigation, Sidebar, Display

Dimensions & Footer	Advanced Settings

What You Can Customize

Operating Modes

Works before and after you adopt multi-tenancy.

Testing

composer test     # Pest — 24 tests, 167 assertions
composer lint     # Pint

License

MIT. See LICENSE.md.

Full docs at docs.ashraficlabs.com/filament-white-label