alizharb/laravel-themer
Enterprise-grade theme management for Laravel. Create, clone, activate, and safely delete themes with per-theme Vite builds, NPM workspaces, asset shortcuts, view overrides, and Livewire 4 support. Includes metadata, wizards, and fast production caching.
Laravel Themer v1.4.0 turns the package into a stronger production theme operations layer for Laravel, Livewire, modular apps, and multi-brand products.
theme:doctor, theme:status, theme:debug, theme:graph, and theme:why.theme:refresh with cache freshness metadata.theme:preview.theme:tokens, theme_token(), theme_tokens(), and [@themeTokens](https://github.com/themeTokens).theme.json metadata.laravel-themer-development skill.composer update alizharb/laravel-themer
php artisan theme:refresh
php artisan theme:doctor
php artisan theme:check
This release makes Laravel Themer more than a theme path resolver. It adds the operational tooling teams need to safely inspect, preview, validate, cache, and automate themes in production.
We are thrilled to announce the release of Laravel Themer v1.3.0! 🎨
This release introduces massive performance optimizations for production environments, vastly improved developer experiences (DX) with new interactive wizards, and foundational architectural upgrades for deeper system integration.
theme:cache command. It now evaluates the full, deep inheritance chain of all themes and serializes them into a single, highly optimized PHP array at bootstrap/cache/themes.php. In production, the ThemeManager boots instantly from this cache, entirely bypassing expensive filesystem scanning.php artisan theme:lint {theme?}. This command safely formats your PHP code using Laravel Pint and concurrently triggers your NPM formatters (npm run format or lint) specifically scoped to the theme's directory.theme:make and theme:activate. Running these commands without arguments now initiates a visually appealing, interactive laravel/prompts wizard to effortlessly guide you through creating and selecting themes.php artisan theme:dev to automatically detect and launch the development server for the currently active theme if a specific theme name isn't provided.theme:make automatically generates robust .gitignore files inside new themes, keeping vendor and build assets out of your git history out of the box.Vite::useBuildDirectory and Vite::useHotFile(). The legacy symlink workaround for theme:publish is gone—themes can now confidently use standard [@vite](https://github.com/vite) tags.?preview_theme=slug query parameter.theme.json (e.g., 'after_activate' => ['php artisan db:seed --class=EcommerceSeeder']).php artisan theme:upgrade utility now gracefully automates schema migrations. It scans existing themes to inject missing .gitignore files and safely initializes the new hooks configurations inside their theme.json.Full Changelog: https://github.com/AlizHarb/laravel-themer/compare/v1.2.1...v1.3.0
Laravel Themer v1.2.0 is a major feature release that elevates the package to a professional, enterprise-grade state. This update introduces isolated asset builds, native NPM Workspaces integration, and a comprehensive suite of lifecycle management commands designed for high-performance, multi-theme applications.
is_theme_active() helper and ThemeManager::isActive() for quick state checks.theme:clone, theme:delete, theme:upgrade.themer:install for optimized dependency sharing.package.json and vite.config.js, allowing independent versioning and unique build configurations.theme:dev and theme:build commands.Theme\{Slug}\ThemeServiceProvider.theme:make now generates professional screenshot placeholders, rich metadata (tags, author, description), and full directory structures.Full Changelog: v1.0.0...v1.2.0
This release brings critical stability improvements to the core theme discovery engine and enhances the development experience with better Blade component support and Filament integration links.
ThemeManager::all() where the collection was being re-indexed with integers. It now correctly preserves string identifiers, ensuring that lookups via slugs and name-based filtering remain 100% reliable.layouts:: and pages:: view namespaces were not automatically registered as Blade component prefixes. Standard component tags like <x-layouts::*> and <x-pages::*> now work as expected out of the box.Artisan::call() within web controllers.Verified with 100% PHPUnit/Pest test coverage and strict PHPStan analysis (Laravel 12 compatible).
Enhanced Documentation & Ecosystem Integration
This maintenance release focuses on improving documentation, developer experience, and ecosystem awareness while maintaining 100% test coverage and strict code quality standards.
laravel-modular, laravel-modular-livewire, laravel-modular-filament, and laravel-hooksthemer:install commandLaravel Themer is now better documented as part of a comprehensive modular ecosystem:
| Package | Purpose |
|---|---|
| laravel-modular | Framework-agnostic modular architecture with zero-config autoloading |
| laravel-modular-livewire | Automatic Livewire 4 component discovery in modules |
| laravel-modular-filament | Filament v5 admin panel integration with modules |
| laravel-hooks | Universal extensibility and plugin system for Laravel 12+ |
composer require alizharb/laravel-themer
php artisan themer:install
This release transforms laravel-themer from a simple theme manager into a production-grade theming engine. It introduces a Zero-IO Discovery caching layer that eliminates filesystem overhead in production and adds support for Deep Multi-Level Inheritance.
AlizHarb\Themer\Http\Middleware\SetTheme middleware allows you to enforce themes at the route level:
Route::middleware('theme:dark-mode')->group(...);
"version" key in theme.json to track theme updates independent of the package.php artisan theme:make now generates a standardized, scalable directory structure with app/Livewire and lang support out of the box.theme:check command now enforces dependencies on laravel-modular modules if defined in your theme config.No breaking changes. Run the following to publish the new configuration and clear old caches:
php artisan vendor:publish --tag=themer-config
php artisan theme:cache
We are excited to announce the first official release of Laravel Themer, a robust and enterprise-grade theme management system specifically engineered for Laravel 11/12 and the TALL stack.
This package empowers you to build multi-themed applications with zero configuration overhead, providing a seamless "first-class" experience that feels like a native part of the framework.
make:view, make:component, make:livewire) that automatically respect the --theme flag.alizharb/laravel-modular, allowing you to treat modules as theme containers.[@vite](https://github.com/vite) to handle theme-specific assets effortlessly.This release has been strictly typed and tested.
Made with ❤️ by Ali Harb
How can I help you explore Laravel packages today?