README

React Starter Kit

A Laravel 13 + React 19 starter kit with a full local service stack — PostgreSQL, Redis, Typesense, RustFS, Mailpit, and Soketi — all orchestrated via Docker Compose and Laravel Sail. Typed frontend with Inertia v3, Wayfinder, shadcn/ui, Tailwind v4, and React Compiler enabled out of the box.

Stack

Layer	Tech
Runtime	PHP 8.5 · Laravel 13 · Laravel Sail (Docker)
Frontend	React 19 · Inertia v3 · TypeScript strict · Vite 8 (`vite-plus`/rolldown) · React Compiler
UI	Tailwind CSS v4 (CSS-first) · shadcn/ui (55 components, `base-nova` preset) · Lucide icons · Storybook 10
Routes ↔ client	Wayfinder — typed TS functions for Laravel routes/actions
Auth	Laravel Fortify (email/password, email verification, 2FA, resets)
Database	PostgreSQL 18
Cache	Database (Postgres)
Sessions/Queues	Redis
Search	Typesense 27.1 (via Laravel Scout)
Object storage	RustFS (S3-compatible) via `league/flysystem-aws-s3-v3`
Mail	Mailpit (local capture)
WebSockets	Soketi (Pusher-compatible)
Testing	Pest 4 (Feature, Unit, Arch, Browser) · Larastan · Rector · Pint
Dev tooling	Telescope · IDE Helper · Laravel Boost (MCP) · Lefthook (git hooks) · Commitlint

Quickstart

Prerequisites: Docker Desktop (or Docker Engine + Compose) and Git. No local PHP or Node install needed — everything runs inside Sail.

git clone <repo-url> laravel-react-starter-kit
cd laravel-react-starter-kit

# Bootstrap PHP dependencies without a local PHP install
docker run --rm \
    -u "$(id -u):$(id -g)" \
    -v "$(pwd):/var/www/html" \
    -w /var/www/html \
    laravelsail/php85-composer:latest \
    composer install --ignore-platform-reqs

cp .env.example .env
vendor/bin/sail up -d
vendor/bin/sail artisan key:generate
vendor/bin/sail artisan migrate
vendor/bin/sail bun install
vendor/bin/sail bun run dev

Open http://localhost for the app and http://localhost:8025 for Mailpit.

For the full guide (git hooks install, service health checks, Storybook, SSR) see docs/getting-started/.

Useful Commands

All commands are prefixed with vendor/bin/sail so they execute inside the container.

# Everything concurrently: server + queue + pail (log tail) + vite
vendor/bin/sail composer run dev

# Tests
vendor/bin/sail composer test              # compact output
vendor/bin/sail composer test:coverage     # enforces 100% code coverage
vendor/bin/sail composer test:types        # enforces 100% type coverage

# Quality gates (lint + refactor dry-run + types + tests)
vendor/bin/sail composer check-all

# Frontend
vendor/bin/sail bun run dev                # Vite dev server (HMR)
vendor/bin/sail bun run build              # production build
vendor/bin/sail bun run storybook          # Storybook on port 6006

Documentation

Full documentation lives in docs/ and is published as a VitePress site. Key sections:

Getting Started — clone, boot, verify services
Architecture — service topology, ports, env drivers, directory layout
- App Configuration — what AppServiceProvider::boot() wires up
- Domain Namespaces — App\Models\{Domain} conventions
Frontend Pipeline — Vite plugins, Inertia resolver, SSR, React Compiler
- shadcn/ui · Storybook · Theming
Authentication — Fortify wiring, Actions, rate limiters, 2FA
Authorization · API · Database
Queue · Search · File Storage · Realtime · Mail
Testing — Pest 4 layout, datasets, browser tests, coverage
Tooling — MCP Servers, Developer Tools, Git Hooks, Static Analysis, Recommended Packages
Deployment

To run the docs locally:

cd docs
bun install
bun run docs:dev

Agentic Development

This repo is tuned for AI coding agents (Claude Code, Cursor, Copilot). AGENTS.md is the minimal brief agents should load at session start; anything deeper lives in docs/. MCP servers wired via .mcp.json:

laravel-boost — project-specific tools (search-docs, database-schema, last-error, browser-logs, …). Always available when Sail is up.
context7 · tavily · jina — optional external MCPs for library docs, web search, and reader-mode URL extraction. See docs/tooling/mcp-servers.md.

License

This starter kit, like the Laravel framework, is open-sourced software licensed under the MIT license.

cmayorgahilario / laravel-starter-kit-inertia-react

Maintainers

Package info

Statistics

Security