rcrosbourne/laravel-react-starter-kit

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

v1.1.3 2026-04-25 16:14 UTC

Requires

• php: ^8.5
• inertiajs/inertia-laravel: ^3.0
• laravel/fortify: ^1.34
• laravel/framework: ^13.0
• laravel/tinker: ^3.0
• laravel/wayfinder: ^0.1.14

Requires (Dev)

• driftingly/rector-laravel: ^2.3
• fakerphp/faker: ^1.24
• larastan/larastan: ^3.9
• laravel/boost: ^2.4
• laravel/pail: ^1.2.5
• laravel/pint: ^1.29
• laravel/sail: ^1.53
• mockery/mockery: ^1.6
• nunomaduro/collision: ^8.9.3
• nunomaduro/pao: ^1.0.3
• pestphp/pest: ^5.0
• pestphp/pest-plugin-browser: ^5.0
• pestphp/pest-plugin-type-coverage: ^5.0
• phpunit/phpunit: ^13.1.7
• rector/rector: ^2.4
• roave/security-advisories: dev-latest

MIT

• postgres
• laravel
• react
• starter-kit
• herd
• bun

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.

What's different from laravel/react-starter-kit?

• 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.

Daily commands

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.

License

MIT.