README

Laravilt Auth

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

Features

🔐 8 Authentication Methods

1. Standard Login & Registration - Email/password authentication with remember me
2. OTP Email Verification - One-time passwords sent via email
3. Two-Factor Authentication - TOTP (Google Authenticator) and email codes
4. Password Reset - Secure password reset flow with email links
5. Social Authentication - OAuth login (GitHub, Google, Facebook, Twitter, etc.)
6. Passkey Authentication - WebAuthn passwordless biometric login
7. Magic Links - Passwordless one-click email authentication
8. 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