README

LaravelDeck is a developer-first, modular installer package for Laravel control panels. It automates setup for roles, permissions, Jetstream + Bootstrap, Livewire, and additional UI tooling such as EasePick, Tabler, and more — all via a single artisan command.

📦 Features

• 🔹 Jetstream installation with Livewire (and Bootstrap!)
• 🔹 Full Spatie permission system integration
• 🔹 Super Admin role & user seeding
• 🔹 EasePick + custom datepicker installer (no Shadow DOM)
• 🔹 Smart trait injection into models
• 🔹 PostCSS auto-backup and restore
• 🔹 Zero Tailwind. All Bootstrap.

🚀 Installation

composer require sapistudio/laraveldeck

🛠 Usage

LaravelDeck exposes a single entry-point command:

php artisan laraveldeck:manage {component}

Available Components:

• install_bootstrap → Installs Jetstream + Bootstrap + Tabler
• install_permissions → Adds Spatie permissions, traits, and migrations
• add_user → Creates a Super Admin user with selected role

You’ll be prompted step-by-step through each setup.

⚙ Example: Full Setup

php artisan laraveldeck:manage install_bootstrap
php artisan laraveldeck:manage install_permissions
php artisan laraveldeck:manage add_user

🧩 File Structure

• Commands/Installer.php – The core installer logic
• Traits/ – Trait injections for models
• Components/Bootstrap/ – Jetstream overrides (Bootstrap based)
• Components/UserRoles/ – Role/User management logic
• Enums/RoleEnum.php – Centralized roles
• Helpers/updateConfigFile.php – Utility for config persistence

🧠 Requirements

• Laravel 11+
• Node.js (for Vite + npm tasks)
• Git (used to clone EasePick repo)

🧰 Helper

You can use the helper class for static info:

use SapiStudio\LaravelDeck\Helpers;

LaravelDeck::version(); // returns current version
LaravelDeck::components(); // available installable components

📄 License

MIT © YourName or Company.