PHPackages                             ashrafic/filament-white-label - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Admin Panels](/categories/admin)
4. /
5. ashrafic/filament-white-label

ActiveLibrary[Admin Panels](/categories/admin)

ashrafic/filament-white-label
=============================

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

v1.0.8(1mo ago)21813MITPHPPHP ^8.2CI passing

Since Jun 16Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/ashrafic/filament-white-label)[ Packagist](https://packagist.org/packages/ashrafic/filament-white-label)[ RSS](/packages/ashrafic-filament-white-label/feed)WikiDiscussions main Synced 2w ago

READMEChangelog (9)Dependencies (4)Versions (11)Used By (0)

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.

---

[![Packagist Version](https://camo.githubusercontent.com/3bce9fd77d65c688b6cd552bc4ae67c810e29cb05cc9d9c4ad65b31703b91f6a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f61736872616669632f66696c616d656e742d77686974652d6c6162656c3f7374796c653d666c61742d73717561726526636f6c6f723d626c7565266c6f676f3d7061636b6167697374)](https://packagist.org/packages/ashrafic/filament-white-label)[![Docs](https://camo.githubusercontent.com/46621e6d27bab4f3cc02605fac355a20916e99488018124872918e9362df43ad/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646f63732d66696c616d656e742d2d77686974652d2d6c6162656c2d626c75653f7374796c653d666c61742d737175617265266c6f676f3d72656164746865646f6373)](https://docs.ashraficlabs.com/filament-white-label)[![PHP Version](https://camo.githubusercontent.com/0ceebfbf3b472ebbb5d577f003bee46634dd6ce551d79f853fb666ebf21f4c14/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253545382e322d3737376262343f7374796c653d666c61742d737175617265266c6f676f3d706870266c6f676f436f6c6f723d7768697465)](https://php.net)[![Filament](https://camo.githubusercontent.com/771369696e7daddd50b80aed7bcd0cd650430f464fda0db435199ceb36e96604/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f66696c616d656e742d253545352e302d6662626632343f7374796c653d666c61742d737175617265266c6f676f3d6c61726176656c)](https://filamentphp.com)[![License](https://camo.githubusercontent.com/086edf9362e6a86d0d3e71265855abe480af163a7a4fdc899d2ea6488917995a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e3f7374796c653d666c61742d737175617265266c6f676f3d6f70656e2d736f757263652d696e6974696174697665)](LICENSE.md)

---

Installation
------------

[](#installation)

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

Panel Registration
------------------

[](#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)
-----------------------------

[](#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
------

[](#guides)

Full docs at **[docs.ashraficlabs.com/filament-white-label](https://docs.ashraficlabs.com/filament-white-label)**

[Getting Started](https://docs.ashraficlabs.com/filament-white-label/getting-started)Overview, requirements, quick start[Installation](https://docs.ashraficlabs.com/filament-white-label/installation)Composer, install command, trait setup[Configuration](https://docs.ashraficlabs.com/filament-white-label/configuration)Full config reference — every option[Features Overview](https://docs.ashraficlabs.com/filament-white-label/features)All customization surfaces at a glance[Brand Settings](https://docs.ashraficlabs.com/filament-white-label/features/brand-settings)Name, logos, colors, fonts, CSS theme, custom CSS[Layout Settings](https://docs.ashraficlabs.com/filament-white-label/features/layout-settings)Navigation, sidebar, breadcrumbs, dimensions, footer[Advanced Settings](https://docs.ashraficlabs.com/filament-white-label/features/advanced-settings)SPA mode, notifications, density, modals, transitions[Branded Login](https://docs.ashraficlabs.com/filament-white-label/features/branded-login)Tenant-branded auth page[Integration Patterns](https://docs.ashraficlabs.com/filament-white-label/features/integration-patterns)Macro, granular trait, manual, conditional[Resolution Flow](https://docs.ashraficlabs.com/filament-white-label/reference/resolution-flow)Tenant → panel → global → config defaults[Cache &amp; Security](https://docs.ashraficlabs.com/filament-white-label/reference/cache-and-security)Caching strategy, CSS sanitization, threat mitigations[Events](https://docs.ashraficlabs.com/filament-white-label/reference/events)WhiteLabelSettingsSaved, WhiteLabelSettingsDeleted---

Screenshots
-----------

[](#screenshots)

Brand IdentityColors[![Brand Identity](https://camo.githubusercontent.com/1183db9fe0864796bbddde2567f3c63a8660f6a79ecef5f87fe4bd861ac22718/68747470733a2f2f646f63732e61736872616669636c6162732e636f6d2f66696c616d656e742d77686974652d6c6162656c2f6173736574732f73637265656e73686f74732f6272616e642d6964656e746974792e706e67)](https://docs.ashraficlabs.com/filament-white-label/features/brand-settings)[![Colors](https://camo.githubusercontent.com/705d40f5930784356013ea284e66567c64d91c81f7a01def9e10ef699d4d415c/68747470733a2f2f646f63732e61736872616669636c6162732e636f6d2f66696c616d656e742d77686974652d6c6162656c2f6173736574732f73637265656e73686f74732f636f6c6f72732e706e67)](https://docs.ashraficlabs.com/filament-white-label/features/brand-settings)Typography, Styling &amp; Custom CSSLayout: Navigation, Sidebar, Display[![Typography & CSS](https://camo.githubusercontent.com/75fa4ae5dfcd98abb4bccdb4a83b3a19705525be495661218ea7673d82209f43/68747470733a2f2f646f63732e61736872616669636c6162732e636f6d2f66696c616d656e742d77686974652d6c6162656c2f6173736574732f73637265656e73686f74732f7479706f6772617068792d7374796c652d637573746f6d2d6373732e706e67)](https://docs.ashraficlabs.com/filament-white-label/features/brand-settings)[![Layout](https://camo.githubusercontent.com/45c77854f65f43ef5c144525d56fa947b74849d508d235424fe6db2964e7c815/68747470733a2f2f646f63732e61736872616669636c6162732e636f6d2f66696c616d656e742d77686974652d6c6162656c2f6173736574732f73637265656e73686f74732f6c61796f75742d6e61762d736964656261722d646973706c61792e706e67)](https://docs.ashraficlabs.com/filament-white-label/features/layout-settings)Dimensions &amp; FooterAdvanced Settings[![Dimensions & Footer](https://camo.githubusercontent.com/ab7312461c818dbcf1d8c65b3401077f6a96ea5390f10ac897f057a36e16a694/68747470733a2f2f646f63732e61736872616669636c6162732e636f6d2f66696c616d656e742d77686974652d6c6162656c2f6173736574732f73637265656e73686f74732f64696d656e73696f6e2d666f6f7465722e706e67)](https://docs.ashraficlabs.com/filament-white-label/features/layout-settings)[![Advanced](https://camo.githubusercontent.com/c9d4c7e55fb22021aa52181513b293837e0794b8872e38777e5130804f4ab38a/68747470733a2f2f646f63732e61736872616669636c6162732e636f6d2f66696c616d656e742d77686974652d6c6162656c2f6173736574732f73637265656e73686f74732f616476616e6365642e706e67)](https://docs.ashraficlabs.com/filament-white-label/features/advanced-settings)---

What You Can Customize
----------------------

[](#what-you-can-customize)

CategoryHighlightsBrand identityName, logo (light + dark), logo height, faviconColors6 roles — palette presets + custom hex pickerTypography49 Google Fonts via CDNCSS themeBorder radius, input radius, badge shape, shadow intensityLayoutTop bar, top nav, collapsible sidebar, breadcrumbsDimensionsContent width, sidebar width, heading sizeDensityFont scale, form density, table row density, modal sizeBehaviorSPA mode, unsaved changes alerts, database notificationsCustom CSSSanitized CSS injection (max 50KB)Login pageBranded auth experience (extends native Filament login)FooterCustom text + dynamic label/URL linksi18nFull translation support — all ~230 strings translatable---

Operating Modes
---------------

[](#operating-modes)

ModeWhenHowMulti-tenant`Filament::getTenant()` resolvesPer-tenant settings recordSingle-tenantNo tenant, global record existsOne global settings recordConfig-onlyNo records exist`config('filament-white-label.defaults.*')`Works **before** and **after** you adopt multi-tenancy.

---

Testing
-------

[](#testing)

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

---

License
-------

[](#license)

MIT. See [LICENSE.md](LICENSE.md).

---

Full docs at **[docs.ashraficlabs.com/filament-white-label](https://docs.ashraficlabs.com/filament-white-label)**

---

 [ ![Ashrafic Labs](https://camo.githubusercontent.com/83d5b0f0097b37fb2efce9e6f5bc6e00ef5a88c4ebeb3f7d37ad67d21b8df09c/68747470733a2f2f61736872616669636c6162732e636f6d2f6272616e642f61736872616669632d6c6162732d6c6f676f2d686f72697a6f6e74616c2d7072696d6172792e737667) ](https://ashraficlabs.com)

 *Built with precision for professionals.*

###  Health Score

46

—

FairBetter than 92% of packages

Maintenance93

Actively maintained with recent releases

Popularity20

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1 days

Total

9

Last Release

34d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/ab06572ecc2701fb9172f587144a4eb20b8e027f75bcc27030e212164c53103c?d=identicon)[ashraful19](/maintainers/ashraful19)

---

Top Contributors

[![ashraful19](https://avatars.githubusercontent.com/u/25670420?v=4)](https://github.com/ashraful19 "ashraful19 (100 commits)")

---

Tags

brandingfilamentfilament-packagefilament-pluginfilamentadminfilamentphplaravelpanelphpwhitelabel

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/ashrafic-filament-white-label/health.svg)

```
[![Health](https://phpackages.com/badges/ashrafic-filament-white-label/health.svg)](https://phpackages.com/packages/ashrafic-filament-white-label)
```

###  Alternatives

[filament/spatie-laravel-settings-plugin

Filament support for `spatie/laravel-settings`.

1143.0M115](/packages/filament-spatie-laravel-settings-plugin)[backstage/mails

View logged mails and events in a beautiful Filament UI.

16321.5k](/packages/backstage-mails)[tapp/filament-lms

193.5k](/packages/tapp-filament-lms)[rawilk/profile-filament-plugin

Profile &amp; MFA starter kit for filament.

3914.8k](/packages/rawilk-profile-filament-plugin)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
