README

🚀 Laravel 12 + React Starter Kit

A modern and flexible starter kit built with Laravel 12, React (Inertia.js + TypeScript), TailwindCSS, and ShadCN UI v4. Designed to accelerate secure, responsive, and customizable dashboard application development.

✨ Features

• 🔐 Full authentication (login, register, reset password)
• 👥 Role & Permission Management (Spatie Laravel Permission)
• 📂 Dynamic Sidebar & Menus based on role & permission
• 🧩 Drag & drop menu management (nested, reorder)
• ⚙️ App settings (name, logo, theme color, SEO)
• 🎨 ShadCN UI v4 + TailwindCSS modern design
• 🌗 Dark/Light mode support
• 🔒 Dynamic access protection via CheckMenuPermission middleware
• ⚠️ Custom 403 Error Page (React-based)
• 💾 Primary color configuration via DB --primary
• 🪪 Audit Log to track user activity
• 📦 Manual & automatic database backup system
• 🗂️ File Manager with folder & file operations

🧱 Tech Stack

🔧 Installation & Setup

# Create project
composer create-project yogijowo/laravel12-react-starterkit my-app
cd my-app

# Backend setup
composer install

# Configure your database settings in .env
php artisan migrate:fresh --seed

# Frontend setup
npm install

# Running dev
composer run dev

Login using:

Email: admin@admin.com
Password: admin123

🚀 Deployment Guide

1. Build Frontend for Production

npm install
npm run build

1. Run Laravel in Production Mode

php artisan config:cache
php artisan route:cache
php artisan view:cache

1. Set File Permissions

chmod -R 775 storage bootstrap/cache
chown -R www-data:www-data .

1. Serve with Web Server (Nginx/Apache) pointing to public/ folder.

🖼️ Application Screenshots

📌 Dashboard (light)

📌 Dashboard (dark)

📌 User Management

📌 Role Management

📌 Permission Management

📌 Menu Manager

📌 App Settings

📌 Audit Logs

📌 Database Backup

📌 File Manager

✅ Manual Test Checklist

☕ Support This Project

If you find this starter kit helpful, consider supporting me:

• 💖 Donate via Ko-fi
• 🧧 Donate via Saweria
• 🙌 Share this repo with others

Your support helps me keep improving this open-source project. Thank you! 🙏

📄 License

Released under the MIT License. Feel free to use it for personal or commercial projects.

🇵🇸 Free Palestine

"You don’t have to be Palestinian to stand for Palestine. You just have to be human."

We stand with the people of Palestine. We reject colonialism, injustice, and violence. Freedom is a human right. FREE PALESTINE 🇵🇸

Created with ❤️ by @yogijowo