README

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

Add the trait to your tenant model:

use FilamentWhiteLabel\Traits\HasWhiteLabel;

class Team extends Model
{
    use HasWhiteLabel;
}

One line in your PanelProvider:

$panel->whiteLabel();

Done. Your tenants see a White Label settings page.

Documentation

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


Getting Started	Overview, requirements, quick start
Installation	Composer, install command, trait setup
Configuration	Full config reference — every option
Features Overview	All customization surfaces at a glance
Brand Settings	Name, logos, colors, fonts, CSS theme, custom CSS
Layout Settings	Navigation, sidebar, breadcrumbs, dimensions, footer
Advanced Settings	SPA mode, notifications, density, modals, transitions
Branded Login	Tenant-branded auth page
Integration Patterns	Macro, granular trait, manual, conditional
Resolution Flow	Tenant → panel → global → config defaults
Cache & Security	Caching strategy, CSS sanitization, threat mitigations
Events	WhiteLabelSettingsSaved, WhiteLabelSettingsDeleted

Screenshots

Brand Identity	Colors

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

Dimensions & Footer	Advanced Settings

What You Can Customize

Category	Highlights
Brand identity	Name, logo (light + dark), logo height, favicon
Colors	6 roles — palette presets + custom hex picker
Typography	49 Google Fonts via CDN
CSS theme	Border radius, input radius, badge shape, shadow intensity
Layout	Top bar, top nav, collapsible sidebar, breadcrumbs
Dimensions	Content width, sidebar width, heading size
Density	Font scale, form density, table row density, modal size
Behavior	SPA mode, unsaved changes alerts, database notifications
Custom CSS	Sanitized CSS injection (max 50KB)
Login page	Branded auth experience (extends native Filament login)
Footer	Custom text + dynamic label/URL links

Operating Modes

Mode	When	How
Multi-tenant	`Filament::getTenant()` resolves	Per-tenant settings record
Single-tenant	No tenant, global record exists	One global settings record
Config-only	No records exist	`config('filament-white-label.defaults.*')`

Works before and after you adopt multi-tenancy.

Requirements

PHP 8.2+
Laravel 11+
Filament v5.x

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

ashrafic/filament-white-label

包简介

README 文档