PHPackages shoplab/shoplab-filament-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. [Admin Panels](/categories/admin) 4. / 5. shoplab/shoplab-filament-theme ActiveFilament-plugin[Admin Panels](/categories/admin) shoplab/shoplab-filament-theme ============================== Custom Linear-inspired theme for Filament v5 panels v1.2.1(4mo ago)0529↓31.3%MITCSSPHP ^8.2CI failing Since Jan 22Pushed 4mo agoCompare [ Source](https://github.com/shoplab/shoplab-filament-theme)[ Packagist](https://packagist.org/packages/shoplab/shoplab-filament-theme)[ RSS](/packages/shoplab-shoplab-filament-theme/feed)WikiDiscussions main Synced today READMEChangelog (1)Dependencies (6)Versions (6)Used By (0) Shoplab Filament Theme ====================== [](#shoplab-filament-theme) [![Latest Version on Packagist](https://camo.githubusercontent.com/78ed915811cd462ca90e6a071b22e2d64d98213269feeab1a230be282013e4e7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f73686f706c61622f73686f706c61622d66696c616d656e742d7468656d652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/shoplab/shoplab-filament-theme)[![GitHub Tests Action Status](https://camo.githubusercontent.com/b14472711a3e781b2b557f50e2b5f059f70cbd767c7923fb68fedee48fa282af/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f73686f706c61622f73686f706c61622d66696c616d656e742d7468656d652f74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/shoplab/shoplab-filament-theme/actions?query=workflow%3Atests+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/e8ebd254fb39a9ac9a728163e5f67330df1850548ba29c0cf9298104eaae6f2b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f73686f706c61622f73686f706c61622d66696c616d656e742d7468656d652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/shoplab/shoplab-filament-theme) A custom Linear-inspired theme for Filament v5 panels. This theme provides a modern, clean interface with refined typography, spacing, and color palettes optimized for multi-tenant applications. Features -------- [](#features) - Linear-inspired design with modern aesthetics - Optimized for both light and dark modes - Custom CSS tokens for consistent design system - Built with Tailwind CSS 4 - Zero JavaScript - pure CSS theming - Automatic service provider registration Requirements ------------ [](#requirements) - PHP 8.2 or higher - Laravel 11 or higher - Filament 5.0 or higher Installation ------------ [](#installation) Install the package via Composer: ``` composer require shoplab/shoplab-filament-theme ``` The service provider will be automatically registered. Usage ----- [](#usage) There are two ways to use this theme with your Filament panels: ### Option 1: Using viteTheme() (Recommended for Development) [](#option-1-using-vitetheme-recommended-for-development) This approach compiles the theme CSS from source using Vite, allowing for hot-reload during development: **1. Add the theme CSS to your Vite configuration:** ``` // vite.config.js export default defineConfig({ plugins: [ laravel({ input: [ 'resources/css/app.css', 'resources/js/app.js', 'vendor/shoplab/shoplab-filament-theme/src/Resources/css/theme.css', ], refresh: true, }), ], }); ``` **2. Use viteTheme() in your panel provider:** ``` use Filament\Panel; public function panel(Panel $panel): Panel { return $panel ->viteTheme('vendor/shoplab/shoplab-filament-theme/src/Resources/css/theme.css') // ... other configuration } ``` ### Option 2: Using the Plugin (Pre-compiled CSS) [](#option-2-using-the-plugin-pre-compiled-css) Use the plugin if you prefer pre-compiled CSS without involving Vite: ``` use Shoplab\FilamentTheme\FilamentThemePlugin; use Filament\Panel; public function panel(Panel $panel): Panel { return $panel ->plugin(FilamentThemePlugin::make()) // ... other configuration } ``` Local Development ----------------- [](#local-development) For local theme development, you can use Composer's path repository feature: **1. Add to your project's `composer.json`:** ``` { "repositories": { "shoplab-theme": { "type": "path", "url": "packages/shoplab/shoplab-filament-theme" } }, "require": { "shoplab/shoplab-filament-theme": "@dev" } } ``` **2. Install the local package:** ``` composer require shoplab/shoplab-filament-theme:@dev ``` This creates a symlink to your local package, enabling instant feedback when editing theme files. **3. Build the theme CSS:** ``` cd packages/shoplab/shoplab-filament-theme npm install npm run build ``` Or use watch mode for automatic rebuilds: ``` npm run dev ``` Customization ------------- [](#customization) To customize the theme, you can: 1. Fork this package 2. Modify `src/Resources/css/theme.css` and `src/Resources/css/tokens.css` 3. Rebuild with `npm run build` 4. Publish your own version to Packagist ### CSS Structure [](#css-structure) - `src/Resources/css/theme.css` - Main theme styles and component overrides - `src/Resources/css/tokens.css` - Design tokens (colors, spacing, typography) Testing ------- [](#testing) Run tests with Pest: ``` composer test ``` Check code style with Pint: ``` composer pint ``` Build CSS assets: ``` npm run build ``` Contributing ------------ [](#contributing) Contributions are welcome! Please feel free to submit a Pull Request. ### Development Setup [](#development-setup) 1. Clone the repository 2. Install dependencies: `composer install && npm install` 3. Make your changes 4. Run tests: `composer test` 5. Check code style: `composer pint` 6. Submit a PR Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for recent changes. License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 40 — FairBetter than 86% of packages Maintenance74 Regular maintenance activity Popularity17 Limited adoption so far Community6 Small or concentrated contributor base Maturity51 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 ~5 days Total 5 Last Release 142d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/b3df09491afeccdc6a44c6d77832a2bab6351759089411399711f2d822d2159c?d=identicon)[JoakimHising](/maintainers/JoakimHising) --- Top Contributors [![JoakimHising](https://avatars.githubusercontent.com/u/1328192?v=4)](https://github.com/JoakimHising "JoakimHising (5 commits)") --- Tags laraveltailwindthemefilamentfilament-plugin ### Code Quality TestsPest Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/shoplab-shoplab-filament-theme/health.svg) ``` [![Health](https://phpackages.com/badges/shoplab-shoplab-filament-theme/health.svg)](https://phpackages.com/packages/shoplab-shoplab-filament-theme) ``` ### Alternatives [openplain/filament-tree-view Tree view for Filament resources - drop-in replacement for Table with drag-and-drop hierarchical data management 3628.2k](/packages/openplain-filament-tree-view)[watheqalshowaiter/filament-sticky-table-header A Filament plugin that makes table headers stick when scrolling down for better UX. 3551.8k](/packages/watheqalshowaiter-filament-sticky-table-header)[caresome/filament-neobrutalism-theme A neobrutalism theme for FilamentPHP admin panels 335.6k1](/packages/caresome-filament-neobrutalism-theme)[inerba/filament-db-config A Filament plugin for database-backed application settings and editable content, with caching and easy page generation. 3513.5k4](/packages/inerba-filament-db-config)[harvirsidhu/filament-cards A Filament-native cards plugin for organizing pages and resources into a card-based navigation hub. 117.1k](/packages/harvirsidhu-filament-cards) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)