README

Filament Themer Luncher is the premium theme management solution for Laravel Themer applications. Effortlessly manage your system's visual identity directly from your Filament admin panel. Install, activate, backup, and restore themes with a beautiful, professional interface.

✨ Features

• 🎨 Visual Management: Full-featured Filament resource for themes.
• 🔄 Live Activation: Switch between themes instantly with a single click.
• 🩺 Theme Health & Diagnostics: Run Theme Doctor, status, debug, and explain actions directly from Filament.
• 🧬 Ecosystem Intelligence: Inspect requires, conflicts, provides, parent health, and design tokens from Laravel Themer 1.4.
• 👁️ Native Preview Flow: Generate Laravel Themer preview URLs from the admin panel.
• ⬇️ Multi-Source Installation: Install themes from:
  • 📂 Local ZIP Uploads
  • 🔗 Direct URLs (ZIP)
  • 🐙 Git Repositories (Private & Public)
  • 📁 Local Paths
• 🛡️ Hardened Operations: Safer ZIP extraction, URL validation, Git process execution, local path allowlists, and secret redaction.
• 💾 Safe Backups: Automated and manual ZIP backups with easy restoration.
• 🔍 Deep Inspection: View theme metadata, authors, and feature support (Livewire, Translations, etc.).
• 🤖 Laravel Boost Ready: Ships AI guidance for safe, native Laravel Themer workflows.
• 🌍 Fully Localized: Professional translations for 11 languages out of the box.
• 🛠️ Modern Laravel Ready: Built for PHP 8.3+ with Laravel 12 and 13 readiness.

🌍 Ecosystem

Enhance your modular and themeable application with our official packages:

• Laravel Themer: Review the core package documentation.
• Filament Modular Luncher: Advanced module management for Filament.
• Laravel Modular: The core modular architecture package.

🚀 Installation

Install the package via Composer:

composer require alizharb/filament-themer-luncher

Register the plugin in your Filament Panel Provider:

use AlizHarb\ThemerLuncher\Filament\Plugins\ThemerLuncherPlugin;

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

🔧 Configuration

Publish the configuration file for customization:

php artisan vendor:publish --tag="themer-luncher-config"

Configuration Options

• installation.allowed_sources: Control where themes can be installed from.
• backups.enabled: Enable or disable the backup system.
• backups.keep_last: Number of backup files to keep per theme.
• authorization.enabled: Enable permission-based access control.

📖 Usage

Installing a Theme

1. Navigate to the Themes resource in your admin panel.
2. Click Install Theme.
3. Choose your source (ZIP, URL, Git, or Local).
4. Fill in the required details and click Install.

Managing Themes

• Activate: Use the "Activate" action to switch the system theme.
• Backup: Click "Backup" to create a ZIP snapshot of the theme directory.
• Restore: Restore a theme to a previous state from the "Backups" tab.
• Publish Assets: Re-publish theme views and public assets.

💖 Sponsors

We would like to extend our thanks to the following sponsors for funding the development of our ecosystem. If you are interested in becoming a sponsor, please visit the GitHub Sponsors page.

🌟 Acknowledgments

• Laravel: For the most elegant PHP framework.
• Filament: For the amazing admin panel builder.
• Spatie: For leading the way in Laravel package development standards.

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING for details.

🔒 Security

If you discover any security-related issues, please email Ali Harb at harbzali@gmail.com.

📄 License

The MIT License (MIT). Please see License File for more information.

Made with ❤️ by Ali Harb