README

An opinionated Laravel 13 + React starter kit for Herd. Bun, Postgres, optional teams, 100% test coverage.

Install

composer create-project rcrosbourne/laravel-react-starter-kit my-app

The post-install hook runs php artisan app:setup, which prompts for teams support and configures .env to match your project directory.

Pass --teams or --no-teams to skip the prompt for non-interactive setups.

bun-first — bun.lock, no npm.
Postgres 17 for dev + test + CI. Test DB derived as <DB_DATABASE>_test.
Herd-first — SMTP catcher on 127.0.0.1:2525, served at http://<project>.test.
100% test coverage gate (Pest line + type-coverage) enforced in CI.
Strict static analysis — Pint + Rector + PHPStan max + Larastan with bleeding edge.
Strict app defaults — Model::shouldBeStrict(), Date::use(CarbonImmutable::class), DB::prohibitDestructiveCommands(isProduction).
AI guidelines generated by laravel/boost (CLAUDE.md, AGENTS.md, etc.).
Optional teams — switcher, invites, owner/member roles, settings page.

Command	What it does
`composer dev`	queue + pail + vite (Herd serves the app)
`composer test`	type-coverage + unit + lint + types (CI path, xdebug)
`composer test:coverage`	local coverage via Herd
`composer lint`	apply Rector + Pint + ESLint fixes
`composer test:lint`	dry-run lint check

See docs/PHILOSOPHY.md for the opinions behind this kit.

MIT.