liraui/auth

An authentication package for LiraUi.

1.0 2025-12-15 09:49 UTC

Requires

• php: ^8.4
• jenssegers/agent: ^2.6
• laravel/wayfinder: ^0.1.12
• laravolt/avatar: ^6.3.1
• pragmarx/google2fa: ^9.0
• spatie/laravel-route-attributes: ^1.25

Requires (Dev)

• laravel/pint: ^1.0
• mockery/mockery: ^1.0
• orchestra/testbench: ^10.8
• pestphp/pest: ^4.1
• pestphp/pest-plugin-browser: ^4.1

MIT

• Ahsan Zia

• Authentication
• laravel
• liraui

README

Auth package

Opinionated authentication package for Laravel, and React applications. This package provides a reusable auth layout and authentication screens: Login, Forgot password, Reset password, Email verification, Profile settings, etc.

⚠️ Beta: This project is in BETA — APIs, file layout, and packages may change. Use for prototyping and early development. Report bugs or breaking changes in issues, please.

What this package provides

• Ready-to-use authentication screens and routes (login, register, forgot/reset password, email verification, profile settings)
• Server-side actions and controllers for common auth flows (register, authenticate, logout, password reset, email verification)
• Two-factor authentication support with enabling/disabling, recovery codes, and verification flows
• One-time access code (OTAC) utilities and stores for short-lived code workflows
• Extensible contracts and action classes so apps can replace behavior via interfaces
• Events, listeners and notifications wired for email verification, password reset, profile updates, and user deletion

Quick start

Install the package with Composer:

composer require liraui/auth

For full installation instructions and documentation, visit the Installation guide.

Testing

composer test
# Tests:    1 skipped, 25 passed (108 assertions)
# Duration: 5.28s

composer test-coverage
# Total: 73.4 % 

Contributing

Bug reports and contributions are welcome — please open an issue or a pull request. Maintain a short description of breaking changes.

License

The auth package is open-sourced licensed under the MIT license.