README

A Laravel + React + Inertia.js starter kit using ArtisanPack UI components.

What's in the box

• Stack: Laravel 12, Inertia.js v2, React 19, Tailwind CSS 4, DaisyUI 5
• Components: @artisanpack-ui/react + @artisanpack-ui/react-laravel adapter
• Auth: login, register, forgot/reset password, email verification, password confirmation, account deletion (controllers + Form Requests + Inertia pages)
• Settings: profile, password, appearance (light/dark/system theme)
• Layouts: shared AppLayout (sidebar + mobile navbar + toast region), AuthLayout, SettingsLayout
• Typed routes: Laravel Wayfinder auto-regenerated by the Vite plugin
• SSR: Inertia SSR builds + an opt-in composer dev:ssr runner
• Tests: 33 Pest tests, CI via GitHub Actions
• Optional packages prompt: pick CMS framework, hooks, media library, code style packages, etc. during install
• Optional modular structure: nwidart/laravel-modules integration

Requirements

• PHP 8.2+
• Composer
• Node.js 20+ and npm

Installation

composer create-project artisanpack-ui/react-starter-kit your-project-name
cd your-project-name
composer dev

The post-create-project-cmd chain runs migrations, prompts for optional packages, and generates Wayfinder route helpers.

Documentation

The docs/ directory has everything: installation, configuration, authentication, components, modular structure, testing, deployment, troubleshooting, FAQ.

License

MIT — see LICENSE.

Credits

• ArtisanPack UI
• Laravel · Inertia.js · React · Tailwind CSS · DaisyUI