Laravel React Auth

A Laravel package that drops in a complete React + Inertia.js authentication system in minutes — login, register, and a protected dashboard, all ready to customise.

Features

📋 Requirements

Installation

1 — Install via Composer

composer require leo76/laravel-react-auth

2 — Run the install command

php artisan react-auth:install

This publishes the config, React pages, and migrations into your project.

3 — Run migrations

php artisan migrate

4 — Install JS dependencies and build

npm install
npm run dev

5 — Configure Inertia middleware

Laravel 11 — bootstrap/app.php :

->withMiddleware(function (Middleware $middleware) {
    $middleware->web(append: [
        \Inertia\Middleware::class,
    ]);
})

Laravel 10 — app/Http/Kernel.php :

protected $middlewareGroups = [
    'web' => [
        // ...
        \Inertia\Middleware::class,
    ],
];

Set the root Blade view in config/inertia.php :

'root_view' => 'app',

Available Routes

Visit /auth/login in your browser to get started.

Configuration

Publish the config file:

php artisan vendor:publish --tag=react-auth-config

config/react-auth.php :

return [

    // URL prefix for all routes → /auth/login, /auth/register ...
    'route_prefix' => env('REACT_AUTH_PREFIX', 'auth'),

    // Eloquent model used for authentication
    'user_model' => \App\Models\User::class,

    // Set to false to disable the /register page and endpoint
    'allow_registration' => env('REACT_AUTH_REGISTRATION', true),

    // Middleware applied to all package routes
    'middleware' => ['web'],

];

Customising the React pages

php artisan vendor:publish --tag=react-auth-assets

Files are copied to :

resources/js/vendor/react-auth/
├── pages/
│   └── Auth/
│       ├── Login.jsx
│       ├── Register.jsx
│       └── Dashboard.jsx
└── components/
    └── InputField.jsx

Edit freely — the package will never overwrite published files.

Publish individually

php artisan vendor:publish --tag=react-auth-config       # Config only
php artisan vendor:publish --tag=react-auth-assets        # React pages + CSS
php artisan vendor:publish --tag=react-auth-migrations    # Migrations only

Testing

composer test

The test suite covers login, register, logout, dashboard access, validation, and the registration toggle.

Package Structure

laravel-react-auth/
├── composer.json
├── config/react-auth.php
├── routes/auth.php
├── src/
│   ├── LaravelReactAuthServiceProvider.php
│   ├── Console/InstallCommand.php
│   ├── Http/
│   │   ├── Controllers/AuthController.php
│   │   └── Middleware/RedirectIfAuthenticated.php
│   └── database/migrations/
├── resources/
│   ├── views/app.blade.php
│   ├── css/app.css
│   └── js/
│       ├── app.jsx
│       ├── components/InputField.jsx
│       └── pages/Auth/
│           ├── Login.jsx
│           ├── Register.jsx
│           └── Dashboard.jsx
└── tests/Feature/AuthTest.php

Changelog

See CHANGELOG.md for recent changes.

🤝 Contributing

Pull requests are welcome! For major changes, please open an issue first.

1. Fork the repository
2. Create your branch: git checkout -b feature/my-feature
3. Commit: git commit -m 'feat: add my feature'
4. Push: git push origin feature/my-feature
5. Open a Pull Request

📄 License

The MIT License (MIT). See LICENSE for more information.

Made with ❤️ for the Laravel community