PHPackages alizharb/laravel-themer - 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. [Framework](/categories/framework) 4. / 5. alizharb/laravel-themer ActiveLibrary[Framework](/categories/framework) alizharb/laravel-themer ======================= A professional theme management system for Laravel 11/12 with first-class Livewire 4 support, strict typing, and zero-config modular integration. 1.3.0(2mo ago)42492MITPHPPHP ^8.2CI passing Since Jan 25Pushed 3mo agoCompare [ Source](https://github.com/AlizHarb/laravel-themer)[ Packagist](https://packagist.org/packages/alizharb/laravel-themer)[ GitHub Sponsors](https://github.com/alizharb)[ RSS](/packages/alizharb-laravel-themer/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (5)Dependencies (34)Versions (7)Used By (2) Laravel Themer ๐ŸŽจ ================ [](#laravel-themer-) [![Laravel Themer Banner](art/banner.png)](art/banner.png) [![Latest Version on Packagist](https://camo.githubusercontent.com/4dcbeb24227a607b1b5a9513965072459b302a8e8956e630c5008b0ad73a0387/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f616c697a686172622f6c61726176656c2d7468656d65722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/alizharb/laravel-themer)[![GitHub Tests Action Status](https://camo.githubusercontent.com/5afa40114efe371c19c0379fc45e77c64897941611c6a8b4f20309fc28ba0459/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f616c697a686172622f6c61726176656c2d7468656d65722f74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/alizharb/laravel-themer/actions?query=workflow%3ATests+branch%3Amain)[![GitHub PHPStan Action Status](https://camo.githubusercontent.com/c2ddbed65382a6f633625bcb9d3c6f9154706945cdbe7de8f20643256b082fb9/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f616c697a686172622f6c61726176656c2d7468656d65722f74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7068707374616e267374796c653d666c61742d737175617265)](https://github.com/alizharb/laravel-themer/actions?query=workflow%3ATests+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/c1af5e8a3c369222159ca25be1fbe89f80127b0dd83fb143a6b583c9b68d5061/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f616c697a686172622f6c61726176656c2d7468656d65722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/alizharb/laravel-themer)[![Licence](https://camo.githubusercontent.com/07b481da3b9ac00fdfbb976c303d3ac039c8a4ce9a5f94b74ad07bdd22197a91/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f616c697a686172622f6c61726176656c2d7468656d65722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/alizharb/laravel-themer) **Laravel Themer** is a robust, enterprise-grade theme management package for Laravel applications. It provides a seamless way to manage themes, including asset publishing, view overrides, Livewire 4 integration, and modular support. Designed for modern TALL stack applications, it simplifies the creation of multi-themed applications without the complexity. โœจ Features ---------- [](#-features) - ๐Ÿ—๏ธ **Independent Vite Builds**: Per-theme `package.json` and `vite.config.js` for total asset isolation. - ๐Ÿ“ฆ **NPM Workspaces**: Zero-config workspace integration for shared dependencies and optimized storage. - โšก **Asset Shortcuts**: Launch dev servers or build theme assets directly via `theme:dev` and `theme:build`. - ๐Ÿ› ๏ธ **Theme Management**: Create, clone, safe-delete, and activate themes with consistent `--theme` support. - ๐Ÿš€ **Zero-IO Discovery**: High-performance architecture that eliminates filesystem scans in production via deep caching. - ๐ŸŒˆ **Rich Metadata**: Support for `screenshots`, `tags`, and management flags (`removable`, `disableable`) in `theme.json`. - โšก **Livewire 4 Integration**: First-class support for Livewire components and layouts with theme-aware resolution. - ๐ŸŽจ **View Overrides**: Intelligent view resolution cascading from Active Theme -> Parent Theme -> Application. - ๐Ÿš€ **Auto-Blade Discovery**: Automatic registration of theme-specific Blade components and inheritance. - ๐Ÿท๏ธ **Theme Versioning**: Support for version metadata in `theme.json` for easier dependency mapping. - ๐Ÿšฆ **Ephemeral Switching**: Temporarily switch themes for specific tasks using `Themer::forTheme()`. - ๐Ÿ›ฃ๏ธ **Route Middleware**: Enforce specific themes for routes or groups via `middleware('theme:name')`. - ๐Ÿงฉ **Modular Support**: Native integration with `laravel-modular` including dependency verification in `theme:check`. - ๐Ÿ›ก๏ธ **Hierarchy Guard**: Built-in validation to detect circular dependencies, missing parents, and asset health. - ๐Ÿ”ง **Artisan Commands**: A comprehensive suite of commands (`make`, `npm`, `dev`, `build`, `clone`, `delete`, `list`, `check`, `cache`) to manage themes. ๐Ÿ“š Documentation --------------- [](#-documentation) For full documentation, please visit [**alizharb.github.io/laravel-themer**](https://alizharb.github.io/laravel-themer) or browse the [docs/](docs/) directory. --- ๐Ÿ“ฆ Installation -------------- [](#-installation) Install the package via Composer: ``` composer require alizharb/laravel-themer ``` ### Quick Start (Recommended) [](#quick-start-recommended) Run the installation command to automatically set up Laravel Themer: ``` php artisan themer:install ``` This interactive command will: - โœ… Publish the configuration file (`config/themer.php`) - โœ… Create the themes directory (default: `themes/`) - โœ… Optionally configure `vite.config.js` with the `themerLoader` for automatic theme asset bundling ### Manual Configuration [](#manual-configuration) If you prefer manual setup or need more control, see the [Installation Guide](docs/installation.md) for detailed instructions on: - Publishing configuration files - Setting up Vite integration - Configuring theme paths and discovery rules --- ๐Ÿ”— Related Packages ------------------ [](#-related-packages) Laravel Themer is part of a comprehensive modular ecosystem for Laravel applications: PackageDescription[**laravel-modular**](https://github.com/AlizHarb/laravel-modular)Framework-agnostic modular architecture with zero-config autoloading and 29+ Artisan command overrides. **Required** for modular theme discovery.[**laravel-modular-livewire**](https://github.com/AlizHarb/laravel-modular-livewire)Official Livewire 4 bridge providing automatic component discovery and registration within modules.[**laravel-modular-filament**](https://github.com/AlizHarb/laravel-modular-filament)Official Filament v5 bridge enabling admin panel integration with automatic resource discovery in modules.[**laravel-hooks**](https://github.com/AlizHarb/laravel-hooks)Universal extensibility and plugin system for Laravel 12+ applications with WordPress-style hooks and filters.[**filament-themer-luncher**](https://github.com/AlizHarb/filament-themer-luncher)A comprehensive Filament v5 interface for managing, switching, and backing up themes.[**filament-modular-luncher**](https://github.com/AlizHarb/filament-modular-luncher)A powerful Filament v5 manager for listing, toggling, and managing system modules.These packages work seamlessly together to provide a complete modular development experience. --- ๐Ÿ“– Usage ------- [](#-usage) ### Creating a Theme [](#creating-a-theme) Generate a new theme with a standard directory structure: ``` php artisan theme:make "Dark Theme" ``` ### Managing Dependencies [](#managing-dependencies) Install packages into a theme workspace directly from the root: ``` php artisan theme:npm --theme=dark-theme install lodash ``` ### Developing Assets [](#developing-assets) Launch a dedicated Vite dev server for your theme: ``` php artisan theme:dev --theme=dark-theme ``` ### Cloning & Deletion [](#cloning--deletion) Safe and fast lifecycle management: ``` # Duplicate an existing theme php artisan theme:clone "Summer Edition" --theme=dark-theme # Safe removal (respects 'removable' flag) php artisan theme:delete --theme=summer-edition ``` ### Activating a Theme [](#activating-a-theme) Switch the active theme globally: ``` php artisan theme:activate dark-theme ``` ### Livewire Integration [](#livewire-integration) The package automatically registers Livewire components within your theme. ``` php artisan make:livewire Header --theme=dark-theme ``` --- ๐Ÿงช Testing --------- [](#-testing) We strictly enforce testing. Use the provided test suite to verify your themes: ``` vendor/bin/pest ``` --- ๐Ÿ’– Sponsors ---------- [](#-sponsors) We would like to extend our thanks to the following sponsors for funding Laravel Themer development. If you are interested in becoming a sponsor, please visit the [Laravel Themer GitHub Sponsors page](https://github.com/sponsors/alizharb). --- ๐Ÿค Contributing -------------- [](#-contributing) We welcome contributions! Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details. 1. Fork the Project 2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`) 3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`) 4. Push to the Branch (`git push origin feature/AmazingFeature`) 5. Open a Pull Request --- ๐ŸŒŸ Acknowledgments ----------------- [](#-acknowledgments) - **Laravel**: For creating the most elegant PHP framework. - **Spatie**: For setting the standard on Laravel package development. --- ๐Ÿ”’ Security ---------- [](#-security) If you discover any security-related issues, please email **Ali Harb** at . ๐Ÿ“„ License --------- [](#-license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. --- Made with โค๏ธ by **Ali Harb** ### Health Score 44 โ€” FairBetter than 92% of packages Maintenance83 Actively maintained with recent releases Popularity20 Limited adoption so far Community10 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 ~6 days Total 6 Last Release 73d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/aa785764ac84cfd4a3237f3d4a3471ce97b479ac6fa2171a5ea8bf369c2377e5?d=identicon)[AlizHarb](/maintainers/AlizHarb) --- Top Contributors [![AlizHarb](https://avatars.githubusercontent.com/u/34816428?v=4)](https://github.com/AlizHarb "AlizHarb (5 commits)") --- Tags laravelpackagethemeThemer ### Code Quality TestsPest Static AnalysisPHPStan, Rector Code StyleLaravel Pint Type Coverage Yes ### Embed Badge ![Health badge](/badges/alizharb-laravel-themer/health.svg) ``` [![Health](https://phpackages.com/badges/alizharb-laravel-themer/health.svg)](https://phpackages.com/packages/alizharb-laravel-themer) ``` ### Alternatives [laravel/cashier Laravel Cashier provides an expressive, fluent interface to Stripe's subscription billing services. 2.5k25.9M107](/packages/laravel-cashier)[laravel/socialite Laravel wrapper around OAuth 1 & OAuth 2 libraries. 5.7k96.9M674](/packages/laravel-socialite)[laravel/pulse Laravel Pulse is a real-time application performance monitoring tool and dashboard for your Laravel application. 1.7k12.1M99](/packages/laravel-pulse)[laravel/horizon Dashboard and code-driven configuration for Laravel queues. 4.2k84.2M225](/packages/laravel-horizon)[laravel/passport Laravel Passport provides OAuth2 server support to Laravel. 3.4k85.0M532](/packages/laravel-passport)[graham-campbell/markdown Markdown Is A CommonMark Wrapper For Laravel 1.3k7.1M64](/packages/graham-campbell-markdown) PHPackages ยฉ 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)