README

A strict, modern Laravel 12 starter that pairs Inertia + React 19 and Tailwind CSS 4, with opinionated DX and guardrails: 100% test and type coverage targets, high level static analysis, automated refactoring, and first‑class formatting.

This is a mix of the official Laravel React Starter Kit and the Nuno Maduro Starter Kit starter kits

Built for rapid app scaffolding while enforcing high code quality.

Features

Laravel 12 with streamlined bootstrap structure and SQLite default
Authentication via laravel/fortify
Inertia.js (server: inertiajs/inertia-laravel, client: @inertiajs/react)
React 19 + TypeScript with Vite 7 and Wayfinder routing helpers
Tailwind CSS v4 with modern utilities and @tailwindcss/vite
Strict Tooling pre-configured:
- Tests: Pest v4, PHPUnit 12 (100% coverage targets)
- Static analysis: Larastan (PHPStan max)
- Refactoring: Rector
- Code style: Laravel Pint + Prettier (TS/TSX)
- Browser testing ready via Pest Browser
Essentials defaults (immutable dates, safe console, eager loading) via nunomaduro/essentials
DX scripts for linting, type checks, and parallel dev processes

Tech Stack

Backend: PHP 8.4, Laravel 12.30.x, Fortify, Wayfinder
Frontend: React 19, TypeScript 5, Inertia React 2, Tailwind 4, Vite 7
Tooling: Pest 4, PHPUnit 12, Larastan 3, Rector 2, Pint 1, Prettier 3, ESLint 9
Runtime: SQLite (default), Queue worker, Laravel Pail for logs

Getting Started

Prerequisites

PHP 8.4+
Composer
Node.js 22+ (Vite 7)
Bun or npm (repository scripts use bun for dev, Prettier for formatting)

Installation

# 1) Install PHP dependencies
composer install

# 2) Install JS dependencies
npm install

# 3) Environment + App key
cp .env.example .env
php artisan key:generate

# 4) Database (SQLite default)
mkdir -p database && touch database/database.sqlite
php artisan migrate

# 5) Run dev servers (app, queue, logs, Vite)
composer dev

Visit the app at http://localhost:8000.

Frontend

Entry points live under resources/ (TS/TSX)
Vite-based dev/build with React plugin and Wayfinder

Common commands:

# Start Vite dev server
npm run dev

# Production build (client + SSR)
npm run build
npm run build:ssr

# Prettier format and check
npm run format
npm run format:check

# Type-check only
npm run types

Backend

Key composer scripts:

# All-in dev orchestration
composer dev

# Lint/fix PHP (Pint), refactor (Rector), then run JS lint
composer lint

# Full test suite with strict gates
composer test

# Individual suites
composer test:unit
composer test:type-coverage
composer test:lint
composer test:types

Fortify provides authentication scaffolding; check routes/ and app/ for actions, requests, and middleware registration via bootstrap/app.php per Laravel 12 conventions.

Testing

Pest v4 is configured for fast unit and browser tests:

# Run full suite (coverage + lint + types)
composer test

# Unit tests with 100% coverage target
a: composer test:unit

# Type coverage (100%)
composer test:type-coverage

# Static analysis and lint gates
composer test:types
composer test:lint

Use datasets and factories for expressive tests. Browser tests live in tests/Browser/.

Code Quality

Pint: opinionated PHP formatting
Rector: safe automated refactoring
Larastan (PHPStan): level max static analysis
Prettier: TS/TSX formatting with Tailwind and organize‑imports plugins
ESLint: modern React, hooks, and TS rules

Run all in one:

composer lint

Project Scripts (Selected)

Composer (composer.json):

dev: parallel app server, queue listener, logs (Pail), and Vite
test:*: coverage, unit, lint, types—with strict thresholds

NPM (package.json):

dev, build, build:ssr
format, format:check, lint
types

Directory Structure (Highlights)

app/ – Laravel application code (actions, controllers, policies, etc.)
bootstrap/ – Application bootstrap (middleware, exceptions, routing)
resources/ – React + Inertia frontend (TS/TSX, styles)
routes/ – Route files (web, console, etc.)
database/ – Migrations, factories, seeders
tests/ – Pest tests (Feature, Unit, Browser)

Configuration Notes

Tailwind v4 uses CSS @import "tailwindcss" (no @tailwind directives)
Wayfinder assists with route discovery while using Vite
Essentials enforces strict runtime defaults (immutable dates, eager loading, etc.)
Default DB is SQLite; swap via .env without code changes

Deployment

Build frontend: npm run build
Run migrations: php artisan migrate --force
Cache config/routes/views as desired: php artisan optimize
Ensure queue workers and logs (Pail) are supervised in production

FAQ

"I don’t see UI changes": ensure the Vite dev server is running (npm run dev) or build assets (npm run build).
"Vite manifest error": run a fresh build. If still failing, clear caches: php artisan optimize:clear.
"Type errors or style diffs": run composer lint and npm run types.

License

This starter is distributed under the MIT license. Components and tools retain their respective licenses (Laravel, Pest, Rector, Pint, Prettier, Tailwind, Inertia, etc.).

martyrer / laravel-starter-kit

Maintainers

Details