Laravel React JSX Boilerplate

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.

What is in this project

Backend

Frontend

App features (included out of the box)

• Welcome page — Laravel-style landing page at /, built as an Inertia React page
• Dark / light / system theme — use-appearance hook + 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.php mounts the React app
• Wayfinder-generated helpers — Route/action modules under resources/js/routes and resources/js/actions

Developer experience

• composer dev — Runs PHP server, queue worker, log tail (Pail), and Vite together
• composer 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

Project structure

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

Requirements

• PHP 8.3+
• Composer 2.x
• Node.js 22+ (recommended)

Getting started

Create a new project

Option A — Laravel installer

laravel new my-app --using=ghostcompiler/laravel-react-jsx-boilerplate.git
cd my-app
composer install && npm install
composer run dev

Option B — Composer

composer create-project ghostcompiler/laravel-react-jsx-boilerplate.git my-app
cd my-app
composer install && npm install
composer run dev

Option 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 dev

Start development

composer run dev

Visit http://localhost:8000.

Manual setup (alternative)

If you skipped composer setup, run:

composer install
cp .env.example .env
php artisan key:generate
php artisan migrate
npm install
npm run build

For local development with HMR:

npm run dev

In a second terminal:

php artisan serve

Scripts

Composer

npm

Adding a new page

1. Create a React page, e.g. resources/js/pages/dashboard.jsx
2. Register a route in routes/web.php:

Route::inertia('/dashboard', 'dashboard')->name('dashboard');

1. Use Wayfinder helpers (regenerated on build) for type-safe links from JSX

What you can build from this

This is intentionally minimal — a blank boilerplate, not a full auth dashboard or starter kit. That makes it a strong base for:

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)

CI / quality

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/phpunit

Or simulate CI with act:

act -j ci -W .github/workflows/tests.yml
act -j quality -W .github/workflows/lint.yml

Repository

https://github.com/ghostcompiler/laravel-react-jsx-boilerplate

Development Environment

Built using ServBay

• Mac M4 Tested
• macOS Apple Silicon
• Powered by ServBay

Repository

https://github.com/ghostcompiler/laravel-react-jsx-boilerplate

License

MIT License