A blank, production-ready boilerplate for building modern Laravel apps with React and JSX — not TypeScript.
Laravel’s official starter kits ship with React + TSX. This boilerplate gives you the same modern stack (Inertia, Vite, Tailwind, Wayfinder) in plain JavaScript/JSX, so you can move fast without TypeScript tooling if that is not your preference.
| Piece | Details |
|---|---|
| Laravel 13 | Latest framework with streamlined routing, middleware, and config |
| Inertia Laravel | Server-driven SPA responses — no separate API layer required for page loads |
| Wayfinder | Type-safe route and action helpers generated from your Laravel routes |
| SQLite by default | Ready for local dev; swap to MySQL/PostgreSQL in .env |
| Queue & jobs tables | Migrations included for background work when you need it |
| PHPUnit | Feature and unit test scaffolding |
| Piece | Details |
|---|---|
| React 19 + JSX | Components in .jsx — no .tsx required |
| Inertia React | Page navigation without full client-side routing setup |
| Vite 8 | Fast HMR in dev, optimized builds for production |
| Tailwind CSS 4 | Utility-first styling via the Vite plugin |
| React Compiler | Enabled through Babel for optimized React rendering |
| Instrument Sans | Loaded via Laravel Vite font plugin (Bunny Fonts) |
- Welcome page — Laravel-style landing page at
/, built as an Inertia React page - Dark / light / system theme —
use-appearancehook + cookie-backed preference, no flash on load - Shared Inertia props — App name, auth user, and layout state wired in
HandleInertiaRequests - Single root Blade view —
resources/views/app.blade.phpmounts the React app - Wayfinder-generated helpers — Route/action modules under
resources/js/routesandresources/js/actions
composer dev— Runs PHP server, queue worker, log tail (Pail), and Vite togethercomposer setup— One-shot install: Composer,.env, key, migrations, npm, build- Linting & formatting — Laravel Pint (PHP), ESLint + Prettier (JS/JSX)
- GitHub Actions — CI tests (PHP 8.3–8.5) and quality checks on push/PR
app/
Http/Middleware/
HandleAppearance.php # Theme cookie → Blade
HandleInertiaRequests.php # Shared Inertia props
resources/
js/
app.jsx # Inertia bootstrapping
pages/welcome.jsx # Example page
hooks/use-appearance.js # Theme toggle logic
routes/ # Wayfinder-generated routes
actions/ # Wayfinder-generated actions
css/app.css # Tailwind entry
views/app.blade.php # Root HTML shell
routes/web.php # Route::inertia('/', 'welcome')
tests/ # PHPUnit feature & unit tests
.github/workflows/ # tests.yml + lint.yml
- PHP 8.3+
- Composer 2.x
- Node.js 22+ (recommended)
Option A — Laravel installer
laravel new my-app --using=ghostcompiler/laravel-react-jsx-boilerplate
cd my-app
composer install && npm install
composer run devOption B — Composer
composer create-project ghostcompiler/laravel-react-jsx-boilerplate my-app
cd my-app
composer install && npm install
composer run devOption C — Clone the repository
git clone https://github.com/ghostcompiler/laravel-react-jsx-boilerplate.git
cd laravel-react-jsx-boilerplate
composer install && npm install
composer run devcomposer run devVisit http://localhost:8000.
If you skipped composer setup, run:
composer install
cp .env.example .env
php artisan key:generate
php artisan migrate
npm install
npm run buildFor local development with HMR:
npm run devIn a second terminal:
php artisan serve| Command | Description |
|---|---|
composer setup |
Full project bootstrap |
composer dev |
Server + queue + logs + Vite |
composer test |
Pint check + PHPUnit |
composer lint |
Fix PHP style with Pint |
composer lint:check |
Check PHP style (CI mode) |
| Command | Description |
|---|---|
npm run dev |
Vite dev server with HMR |
npm run build |
Production asset build |
npm run lint |
ESLint on resources/js |
npm run lint:fix |
ESLint with auto-fix |
npm run format |
Prettier check |
npm run format:fix |
Prettier write |
- Create a React page, e.g.
resources/js/pages/dashboard.jsx - Register a route in
routes/web.php:
Route::inertia('/dashboard', 'dashboard')->name('dashboard');- Use Wayfinder helpers (regenerated on build) for type-safe links from JSX
This is intentionally minimal — a blank boilerplate, not a full auth dashboard or starter kit. That makes it a strong base for:
| Use case | How this boilerplate helps |
|---|---|
| SaaS dashboards | Add auth (Fortify/Breeze), layouts, and Inertia pages on top of the existing middleware stack |
| Internal tools | Laravel for data, permissions, and queues; React for interactive UI without a separate SPA repo |
| CRUD admin panels | Models, migrations, controllers, and Inertia forms — Wayfinder keeps routes in sync |
| Marketing sites + app | Blade or Inertia landing pages, shared Tailwind theme, dark mode already wired |
| API-backed products | Start Inertia-first; add API routes later if mobile or third-party clients are needed |
| Learning Laravel + React | Official Laravel docs apply; frontend examples use JSX instead of TSX |
Typical next steps:
- Add authentication (Laravel Fortify or Breeze adapted for JSX)
- Create a layout component and shared navigation
- Add form components with Inertia
useForm - Connect Eloquent models and policies for your domain
- Enable queues for emails, imports, or webhooks (tables already migrated)
GitHub Actions run on pushes and pull requests to main, master, develop, and workos:
- tests.yml — PHPUnit across PHP 8.3, 8.4, and 8.5
- lint.yml — Pint, Prettier, and ESLint
Run the same checks locally:
composer lint:check
npm run format
npm run lint
./vendor/bin/phpunitOr simulate CI with act:
act -j ci -W .github/workflows/tests.yml
act -j quality -W .github/workflows/lint.ymlhttps://github.com/ghostcompiler/laravel-react-jsx-boilerplate
Built using ServBay
- Mac M4 Tested
- macOS Apple Silicon
- Powered by ServBay
https://github.com/ghostcompiler/laravel-react-jsx-boilerplate
MIT License
