equidna/swift-auth

Bottled authentication for Laravel projects

2.0.0 2025-12-15 18:15 UTC

Requires

• php: ^8.2 || ^8.3 || ^8.4
• equidna/bird-flock: ^1.0
• equidna/laravel-toolkit: ^1.0
• illuminate/support: ^11.21 || ^12.0
• inertiajs/inertia-laravel: ^1.3 || ^2.0
• laragear/webauthn: ^4.0
• laravel/framework: ^11.21 || ^12.0
• laravel/helpers: ^1.8
• laravel/sanctum: ^4.2

Requires (Dev)

• larastan/larastan: ^3.0
• orchestra/testbench: ^9.0
• phpunit/phpunit: ^11.5
• squizlabs/php_codesniffer: ^4.0
• stevebauman/autodoc-facades: ^1.0

MIT

• Gabriel Ruelas
• Raul Cruz
• Guillermo Corona

README

Bottled authentication for Laravel projects.

SwiftAuth is a production-ready authentication package for Laravel that provides a robust, secure, and flexible identity management system. It supports traditional session-based auth, multi-factor authentication (OTP & WebAuthn/Passkeys), role-based access control, and comprehensive session management.

This package is designed to be a drop-in solution for Laravel applications requiring enterprise-grade authentication features without the boilerplate.

Documentation Index

• Deployment Instructions
• API Documentation (Public Endpoints)
• Routes Documentation
• Artisan Commands
• Tests Documentation
• Architecture Diagrams
• Monitoring
• Business Logic & Core Processes
• Open Questions & Assumptions

This documentation and the codebase follow the project’s Coding Standards Guide and PHPDoc Style Guide.

Tech Stack & Requirements

• Type: Laravel Package
• PHP: 8.2+
• Laravel: 11.x / 12.x
• Key Dependencies:
  • equidna/bird-flock (Notification Bus)
  • laragear/webauthn (Passkey Support)
  • inertiajs/inertia-laravel (Frontend Interop)
  • laravel/sanctum (API Tokens)

Quick Start

1. Install the package:

   composer require equidna/swift-auth

2. Publish assets and configuration:

   php artisan swift-auth:install

   This will publish the config file (config/swift-auth.php), migrations, and frontend assets.

3. Run migrations:

   php artisan migrate

4. Create an initial admin user:

   php artisan swift-auth:create-admin-user

5. Serve and visit:

   Start your server:

   php artisan serve

   Visit /swift-auth/login (or your configured route prefix) to see the login page.