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

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.