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

sapistudio / laraveldeck

Maintainers

Details