README

Laravilt Auth

Complete authentication system for Laravilt with 8 authentication methods, 20+ events, custom pages, and multi-panel support.

Features

🔐 8 Authentication Methods

Standard Login & Registration - Email/password authentication with remember me
OTP Email Verification - One-time passwords sent via email
Two-Factor Authentication - TOTP (Google Authenticator) and email codes
Password Reset - Secure password reset flow with email links
Social Authentication - OAuth login (GitHub, Google, Facebook, Twitter, etc.)
Passkey Authentication - WebAuthn passwordless biometric login
Magic Links - Passwordless one-click email authentication
Connected Accounts - Link multiple auth providers to one account

📡 20+ Events

LoginAttempt, LoginSuccessful, LoginFailed
RegistrationAttempt, RegistrationCompleted
OtpSent, OtpVerified, OtpFailed
TwoFactorEnabled, TwoFactorDisabled, TwoFactorChallengeFailed, TwoFactorChallengeSuccessful
PasswordResetRequested, PasswordReset
SocialAuthenticationAttempt, SocialAuthenticationFailed, SocialAuthenticationSuccessful
PasskeyRegistered, PasskeyAuthenticated
MagicLinkSent

🎨 Custom Pages & Multi-Panel Support

Replace any page and configure different authentication methods per panel.

Installation

Composer

composer require laravilt/auth

NPM

npm install @laravilt/auth

Quick Start

Basic Panel Setup

use Laravilt\Panel\Panel;

Panel::make('admin')
    ->login()                              // Enable login
    ->registration()                       // Enable registration
    ->passwordReset()                      // Enable password reset
    ->emailVerification()->otp()           // Enable OTP verification
    ->twoFactor()                          // Enable 2FA
    ->socialAuth(['github', 'google'])     // Enable social auth
    ->passkeys()                           // Enable passkeys
    ->magicLinks();                        // Enable magic links

Custom Pages

use App\Auth\CustomLogin;

Panel::make('admin')
    ->login(CustomLogin::class);  // Use custom login page

Event Listeners

use Laravilt\Auth\Events\LoginSuccessful;

Event::listen(LoginSuccessful::class, function ($event) {
    Log::info('User logged in: ' . $event->user->email);
});

Vue/TypeScript Usage

import { LoginPage, RegisterPage } from '@laravilt/auth'
import { useAuth } from '@laravilt/auth'

const { user, logout } = useAuth()

Publishing

Build for NPM

npm run build:npm

Publish to NPM

npm publish --access public

Publish to Packagist

git tag v1.0.0
git push origin master --tags

MCP Server

AI-assisted development with MCP tools:

search-docs - Search auth documentation
get-event-info - Get event details
list-auth-methods - List authentication methods

Documentation

Complete Docs: docs/index.md
Test Summary: TEST_SUMMARY.md
Website: https://laravilt.dev/auth

Testing

composer test

Coverage: 26 tests | 70 assertions | All events tested

Requirements

PHP 8.3+
Laravel 12+
Vue 3.3+
Inertia.js 2.0+

License

MIT License - see LICENSE.md

Credits

Author: Fady Mondy (info@3x1.io) Website: https://laravilt.dev

laravilt / auth

Maintainers

Details