Clarity Theme

• A theme for Filament 4 and 5, with dedicated release lines
• Coverage and boundaries
• Choose your release line
• Install through Privato
• Recommended panel configuration
• Opt in per panel, including multiple panels
• Customisation
• Gallery: light and dark
• Licensing and upgrades

#A theme for Filament 4 and 5, with dedicated release lines

Clarity keeps tables, forms and navigation consistent without requiring component rewrites.

Filament 4 is supported on the 1.x line with PHP 8.2+, while Filament 5 is supported on the 2.x line with PHP 8.4+.

Install from Privato, register one plugin on the panel you choose, and keep your existing resources, pages and business views. No Node build or component rewrite is required.

#Coverage and boundaries

The theme covers sidebar, topbar, page headers, buttons, fields, tables, pagination, stats, badges, dropdowns, modals, notifications and empty states in light and dark mode.

Wizards, the rich editor toolbar, builder and repeater chrome, and the command palette remain in Filament's stock style.

#Choose your release line

Clarity follows Filament's major versions. The stylesheet targets internal .fi-* markup, so each line is tested as its own product rather than promising one combined dependency range.

Use the line matching your application's Filament major. This guide installs the current 2.x line; the 1.x guide uses the same Privato flow with ^1.0.

#Install through Privato

** Launch special: use code CLARITY10 to get $10 off. **

The price is US$39 (US$29) as a flat-rate, one-time purchase. Use the Privato checkout to obtain a licence.

Configure the Privato Composer registry, authenticate, and require the 2.x package:

composer config repositories.wiremodel composer https://wiremodel.privato.pub/composer
composer config --auth http-basic.wiremodel.privato.pub "<EMAIL>" "<KEY>"
composer require wiremodel/filament-clarity-theme:^2.0

EMAIL and KEY come from your licence in Privato. Keep them out of version control and use Composer's local auth storage.

Register the plugin on the panel you want to theme:

use Wiremodel\FilamentClarityTheme\ClarityThemePlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugin(ClarityThemePlugin::make());
}

Publish the stylesheet after installation:

php artisan filament:assets

Clarity has no theme configuration options by design; your panel resources and business views stay yours.

#Recommended panel configuration

Clarity was drawn with Figtree and a 270px sidebar. Both settings are optional, but matching them gives you the intended rhythm and screenshot fidelity.

return $panel
    ->plugin(ClarityThemePlugin::make())

    //without topbar
    ->topbar(false)

    //sidebar collapsible
    ->sidebarCollapsibleOnDesktop()

    // Clarity was drawn with Figtree. Any font works, but the panel will not
    // match the screenshots without it. This URL fetches from a third-party
    // CDN, which is a data transfer your privacy policy may need to cover, and
    // which fails on an air-gapped install. Self-host the font instead if
    // either applies to you.
    ->font('Figtree', url: 'https://fonts.bunny.net/css?family=figtree:400,500,600,700,800&display=swap')

    // Filament defaults to 20rem. Clarity's spacing was tuned at 270px.
    ->sidebarWidth('270px');

To self-host Figtree, serve the font files from your application and point url at your stylesheet, or use Filament's LocalFontProvider.

#Opt in per panel, including multiple panels

Clarity is opt-in per panel. A panel without the plugin remains untouched, so an admin panel and a customer panel can use different visual systems in one application.

#Customisation

Clarity ships inside a clarity cascade layer. Unlayered CSS in your panel theme wins over any layer, so your own rules can customise the surface directly:

/* resources/css/filament/admin/theme.css */
@import '../../../../vendor/filament/filament/resources/css/theme.css';

.fi-btn {
    border-radius: 4px;
}

No !important or specificity escalation is needed. Design tokens are readable and overridable too:

:root {
    --radius-clarity-xl: 0.5rem;
}

#Gallery: light and dark

Every surface has a dark counterpart. Dark mode follows the panel's own toggle and derives dark values from the panel's grey palette rather than fixed colours.

#Licensing and upgrades

One licence covers one production project, with unlimited developers and unlimited non-production environments. Read the full terms in https://wiremodel.privato.pub/portal/filament-clarity-theme.

The theme styles Filament's internal .fi-* class names. Constrain Filament in your application and review the panel visually after upgrades, because a Filament release can change markup without a package code change.