README

Fortify-based authentication with Livewire views for Laravel. Drop-in auth scaffold with login, registration, password reset, email verification, two-factor authentication, and a profile page.

Requirements

• PHP 8.3+
• Laravel 13
• Livewire 4

Installation

composer require lornequinn/auth

The package auto-discovers via Laravel's package discovery. No manual provider registration needed.

Publish the config:

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

Database

Run the Fortify migrations (if you haven't already):

php artisan migrate

Your User model must implement MustVerifyEmail if you want email verification:

use Illuminate\Contracts\Auth\MustVerifyEmail;

class User extends Authenticatable implements MustVerifyEmail
{
    // ...
}

For two-factor authentication, add the TwoFactorAuthenticatable trait:

use Laravel\Fortify\TwoFactorAuthenticatable;

class User extends Authenticatable implements MustVerifyEmail
{
    use TwoFactorAuthenticatable;
}

What You Get

Routes

Livewire Components

All components are registered under the lq-auth prefix:

• lq-auth.login
• lq-auth.register
• lq-auth.forgot-password
• lq-auth.reset-password
• lq-auth.verify-email
• lq-auth.confirm-password
• lq-auth.two-factor-challenge
• lq-auth.dashboard
• lq-auth.profile.show
• lq-auth.profile.update-profile-information
• lq-auth.profile.update-password
• lq-auth.profile.two-factor-authentication

Configuration

After publishing, edit config/lq-auth.php:

Layouts

'guest_layout' => 'lq-auth::layouts.guest',
'app_layout' => 'lq-auth::layouts.app',

Override these to use your own layouts. The package ships minimal layouts — point these at your app's layout views or a UI package.

Features

Toggle any Fortify feature:

'features' => [
    'registration' => true,
    'reset-passwords' => true,
    'email-verification' => true,
    'update-profile-information' => true,
    'update-passwords' => true,
    'two-factor-authentication' => true,
],

Post-Login Redirect

'home' => '/dashboard',

Middleware

Middleware for authenticated routes (dashboard, profile):

'middleware' => ['web', 'auth', 'verified'],

Custom Actions

Override Fortify action classes with your own:

'actions' => [
    'create_user' => App\Actions\CreateNewUser::class,
    'update_profile' => null, // null = use package default
    'update_password' => null,
    'reset_password' => null,
],

Customising Views

Publish the views:

php artisan vendor:publish --tag=lq-auth-views

Views are published to resources/views/vendor/lq-auth/. Edit them directly.

License

MIT