PHPackages                             benriadh1/filament-benriadh-theme - 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. [Templating &amp; Views](/categories/templating)
4. /
5. benriadh1/filament-benriadh-theme

ActiveLibrary[Templating &amp; Views](/categories/templating)

benriadh1/filament-benriadh-theme
=================================

A Filament v5 ERP-inspired theme package.

1.0.0(1mo ago)024MITPHPPHP ^8.2

Since May 5Pushed 4w agoCompare

[ Source](https://github.com/benriadh1/filament-benriadh-theme)[ Packagist](https://packagist.org/packages/benriadh1/filament-benriadh-theme)[ RSS](/packages/benriadh1-filament-benriadh-theme/feed)WikiDiscussions main Synced 3w ago

READMEChangelog (1)Dependencies (8)Versions (3)Used By (0)

Filament Benriadh Theme
=======================

[](#filament-benriadh-theme)

[![Latest Version on Packagist](https://camo.githubusercontent.com/ac8a138fb7c38ebd7c27569887cc401763583a214c1252b475699447df482a50/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f62656e7269616468312f66696c616d656e742d62656e72696164682d7468656d652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/benriadh1/filament-benriadh-theme)[![Total Downloads](https://camo.githubusercontent.com/b9e4e960e95623f8ebcb646c3d0878971ec3b6aee4a4d940822a9f6cc06a2a8b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f62656e7269616468312f66696c616d656e742d62656e72696164682d7468656d652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/benriadh1/filament-benriadh-theme)

A reusable Filament v5 theme package built with a token-first architecture, preset system, accessibility guardrails, and extension hooks for long-term upgrade safety.

Release version: `1.0.0`

Highlights
----------

[](#highlights)

- Token-first design with semantic tokens (`surface`, `text`, `primary`, `danger`, etc.)
- Preset system (`corporate`, `minimal`, `bold`, `neutral`) + import/export commands
- Light / Dark / Auto mode handling
- Zero-config installer command for fast setup
- Panel-level overrides and optional tenant-level branding resolver
- Theme Settings page with multilingual support (EN, FR, AR, DE, ES, PT)
- Plugin compatibility adapter layer with a `TranslationManagerAdapter` reference
- Accessibility guardrails (focus ring, reduced motion, WCAG contrast audit command)
- Upgrade-safe schema (`schema_version`) + migration command for legacy config
- CSS injection–safe token pipeline with color and value sanitization
- Per-request theme resolution cache for zero-overhead render hooks

Requirements
------------

[](#requirements)

- PHP `^8.2`
- Laravel `^11.0 || ^12.0 || ^13.0`
- Filament `^5.0`

Zero-Config Install
-------------------

[](#zero-config-install)

```
composer require benriadh1/filament-benriadh-theme
php artisan filament-benriadh-theme:install --migrate
```

Manual install remains available:

```
php artisan vendor:publish --tag="filament-benriadh-theme-config"
php artisan vendor:publish --tag="filament-benriadh-theme-assets"
php artisan vendor:publish --tag="filament-benriadh-theme-lang"
php artisan vendor:publish --tag="filament-benriadh-theme-migrations"
php artisan migrate
```

Register In Panel
-----------------

[](#register-in-panel)

```
use Benriadh1\FilamentBenriadhTheme\FilamentBenriadhThemePlugin;

public function panel(Panel $panel): Panel
{
    return $panel->plugins([
        FilamentBenriadhThemePlugin::make(),
    ]);
}
```

Fluent API
----------

[](#fluent-api)

```
FilamentBenriadhThemePlugin::make()
    ->preset('corporate')
    ->mode('auto')
    ->accentColor('#cba24c')
    ->sidebarGradient('#0f172a', '#111827')
    ->showLeftSidebar(true)
    ->compactSidebar(false)
    ->cardRadius('0.9rem')
    ->softShadows(true)
    ->tokens([
        'primary' => '#2563eb',
    ])
    ->layout([
        'compact_sidebar' => true,
    ]);
```

Config Model
------------

[](#config-model)

Main config file: `config/filament-benriadh-theme.php`

Core keys:

- `schema_version`
- `asset_path`
- `mode`
- `preset`
- `presets`
- `tokens`
- `layout`
- `breadcrumbs`
- `branding`
- `apps_dropdown`
- `panel_overrides`
- `tenant`
- `extensions`
- `a11y`
- `show_theme_settings_page`

Legacy keys are still supported and mapped into v1 schema for backward compatibility.

### Apps Dropdown

[](#apps-dropdown)

Controls the navigation grid shown in the topbar when the sidebar is hidden:

```
'apps_dropdown' => [
    'max_items' => 15, // Maximum navigation items shown in the grid
],
```

Localization
------------

[](#localization)

The Theme Settings page is translated into 6 languages out of the box:

CodeLanguage`en`English`fr`French`ar`Arabic (RTL)`de`German`es`Spanish`pt`PortuguesePublish the language files to customize or add new locales:

```
php artisan vendor:publish --tag="filament-benriadh-theme-lang"
```

Files are placed under `lang/vendor/filament-benriadh-theme/{locale}/messages.php`.

Panel + Tenancy Support
-----------------------

[](#panel--tenancy-support)

- Use `panel_overrides` to provide per-panel visual behavior.
- Use `tenant.enabled` + `tenant.resolver` to inject tenant branding at runtime.
- Tenant resolver contract:
    - `Benriadh1\FilamentBenriadhTheme\Contracts\TenantThemeResolver`

Extension API
-------------

[](#extension-api)

Implement these contracts to extend without forking:

- `Benriadh1\FilamentBenriadhTheme\Contracts\ThemeTokenTransformer`
- `Benriadh1\FilamentBenriadhTheme\Contracts\PluginThemeAdapter`
- `Benriadh1\FilamentBenriadhTheme\Contracts\TenantThemeResolver`

### Plugin Adapter Example

[](#plugin-adapter-example)

The package ships with `TranslationManagerAdapter` as a reference implementation. It bridges the optional `benriadh1/filament-translation-manager` package by mapping its CSS variables to theme tokens. To activate it (or any custom adapter), register it in your config:

```
'extensions' => [
    'plugin_adapters' => [
        \Benriadh1\FilamentBenriadhTheme\Adapters\TranslationManagerAdapter::class,
        // or your own adapter:
        App\Theme\MyPluginAdapter::class,
    ],
],
```

The adapter is automatically skipped when the target plugin is not installed.

Commands
--------

[](#commands)

```
php artisan filament-benriadh-theme:install --migrate
php artisan filament-benriadh-theme:migrate-schema
php artisan filament-benriadh-theme:preset-export corporate
php artisan filament-benriadh-theme:preset-import ./preset.json my_custom --overwrite
php artisan filament-benriadh-theme:a11y-check --panel=admin
```

Theme Settings Page
-------------------

[](#theme-settings-page)

When enabled, the package registers:

- Navigation: `Settings > Theme Settings`
- Route (default admin panel): `/admin/theme-settings`

Values are stored in `filament_theme_settings` and merged with config + runtime overrides.

Testing
-------

[](#testing)

```
composer install
composer test        # runs Pest
composer lint        # runs Laravel Pint
```

Test coverage includes CSS injection sanitization, color token validation, theme mode normalization, `ThemeSetting::store()` idempotency, and WCAG contrast ratio math.

Roadmap
-------

[](#roadmap)

### v1 (current)

[](#v1-current)

- Token-first config schema
- Presets + mode handling
- Panel/tenant/extensibility hooks
- Install/migrate/preset/a11y command set
- Multilingual Theme Settings page (EN, FR, AR, DE, ES, PT)

### v2

[](#v2)

- Broader component parity coverage for complex Filament states
- Additional first-party plugin adapters
- Design token validation tooling with stricter schema checks

### v3

[](#v3)

- Visual regression suite (light/dark, desktop/mobile)
- Interactive playground UI for live token editing + export
- Expanded docs with adapter and tenancy recipes

License
-------

[](#license)

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

###  Health Score

41

—

FairBetter than 87% of packages

Maintenance92

Actively maintained with recent releases

Popularity10

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity47

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 ~35 days

Total

2

Last Release

55d ago

### Community

Maintainers

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

---

Top Contributors

[![benriadh1](https://avatars.githubusercontent.com/u/25374914?v=4)](https://github.com/benriadh1 "benriadh1 (6 commits)")

---

Tags

laravelthemeERPfilamentfilament-v5

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/benriadh1-filament-benriadh-theme/health.svg)

```
[![Health](https://phpackages.com/badges/benriadh1-filament-benriadh-theme/health.svg)](https://phpackages.com/packages/benriadh1-filament-benriadh-theme)
```

###  Alternatives

[moonshine/moonshine

Laravel administration panel

1.3k239.9k76](/packages/moonshine-moonshine)[andreia/filament-nord-theme

A minimalist Arctic Nord theme for FilamentPHP

13640.5k2](/packages/andreia-filament-nord-theme)[filafly/brisk

A simple, friendly theme for Filament.

2215.7k2](/packages/filafly-brisk)[ublabs/blade-simple-icons

A package to easily make use of Simple Icons in your Laravel Blade views.

1958.8k](/packages/ublabs-blade-simple-icons)[a2insights/filament-saas

Filament Saas for A2Insights

171.5k](/packages/a2insights-filament-saas)

PHPackages © 2026

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