README

Website | Documentation | GitHub

Beautiful, customizable authentication views for Laravel 12 – Tyro Login provides professional, ready-to-use login and registration pages with multiple layout options and seamless integration with the Tyro package.

Features

Multiple Layouts - 5 beautiful layouts: centered, split-left, split-right, fullscreen, and card
Beautiful Design - Modern, professional UI out of the box
Social Login - OAuth authentication with Google, Facebook, GitHub, Twitter/X, LinkedIn, Bitbucket, GitLab, and Slack
Enhanced Security - Industry-standard security features
- Encrypted OAuth token storage at rest (using Laravel's encryption)
- Cryptographically secure OTP generation (Better Randomness)
- Session regeneration to prevent fixation attacks (on successful login and logout)
- CSRF-protected logout (only accept POST calls)
- Privacy-compliant debug logging (email addresses masked)
Highly Configurable - Customize colors, logos, redirects, and more
Lockout Protection - Rate limiting with configurable attempts and duration
Math Captcha - Simple addition/subtraction captcha for login and registration
Login OTP - Two-factor authentication via email OTP codes
Email Verification - Optional email verification for new registrations
Password Reset - Built-in forgot password and reset functionality
Beautiful Emails - Sleek, minimal HTML email templates for OTP, password reset, verification, and welcome emails
Tyro Integration - Automatic role assignment for new users if Tyro is installed
Dark/Light Theme - Automatic theme detection with manual toggle
Fully Responsive - Works perfectly on all devices
Zero Build Step - No npm or webpack required, just install and use
Debug Mode - Privacy-safe debug logging for development

Requirements

PHP 8.2 or higher
Laravel 12.0 or higher

Installation

Install the package via Composer:

composer require hasinhayder/tyro-login

Run the installation command:

php artisan tyro-login:install

For social login support, use:

php artisan tyro-login:install --with-social

That's it! Visit /login to see your new authentication pages.

Configuration

After installation, you can customize the package by editing config/tyro-login.php:

Layout Options

// Available layouts: 'centered', 'split-left', 'split-right', 'fullscreen', 'card'
'layout' => env('TYRO_LOGIN_LAYOUT', 'centered'),

// Background image for split and fullscreen layouts
'background_image' => env('TYRO_LOGIN_BACKGROUND_IMAGE', 'https://...'),

Branding

'branding' => [
    'app_name' => env('TYRO_LOGIN_APP_NAME', 'Laravel'),
    'logo' => env('TYRO_LOGIN_LOGO', null), // URL to your logo
    'logo_height' => env('TYRO_LOGIN_LOGO_HEIGHT', '48px'),
],

Redirects

'redirects' => [
    'after_login' => env('TYRO_LOGIN_REDIRECT_AFTER_LOGIN', '/'),
    'after_logout' => env('TYRO_LOGIN_REDIRECT_AFTER_LOGOUT', '/login'),
    'after_register' => env('TYRO_LOGIN_REDIRECT_AFTER_REGISTER', '/'),
    'after_email_verification' => env('TYRO_LOGIN_REDIRECT_AFTER_EMAIL_VERIFICATION', '/login'),
],

Registration Settings

'registration' => [
    'enabled' => env('TYRO_LOGIN_REGISTRATION_ENABLED', true),
    'auto_login' => env('TYRO_LOGIN_REGISTRATION_AUTO_LOGIN', true),
    'require_email_verification' => env('TYRO_LOGIN_REQUIRE_EMAIL_VERIFICATION', false),
],

Email Verification

When email verification is enabled, users won't be logged in automatically after registration. Instead, they'll be redirected to a verification notice page and a verification link will be generated.

'registration' => [
    'require_email_verification' => env('TYRO_LOGIN_REQUIRE_EMAIL_VERIFICATION', true),
],

'verification' => [
    'expire' => env('TYRO_LOGIN_VERIFICATION_EXPIRE', 60), // Token expires in 60 minutes
],

'redirects' => [
    'after_email_verification' => env('TYRO_LOGIN_REDIRECT_AFTER_EMAIL_VERIFICATION', '/login'),
],

How it works:

User registers - Redirected to verification notice page
Verification URL is logged to Laravel logs and error_log (for development)
User clicks the link - Email is verified and user is redirected to login page
Users can request a new verification email from the notice page
If user tries to login with unverified email, they see "Email Not Verified" page

For Development: The verification URL is printed to your Laravel logs and error_log, so you can easily test without setting up email.

Password Reset

Tyro Login includes a complete password reset flow with beautiful, consistent UI.

'password_reset' => [
    'expire' => env('TYRO_LOGIN_PASSWORD_RESET_EXPIRE', 60), // Token expires in 60 minutes
],

How it works:

User clicks "Forgot Password?" on login page
User enters email - Reset link is generated
Reset URL is logged to Laravel logs and error_log (for development)
User clicks the link - Shown password reset form
User enters new password - Password updated and user is logged in

For Development: The reset URL is printed to your Laravel logs and error_log, so you can easily test without setting up email.

Tyro Integration

If you have hasinhayder/tyro installed, Tyro Login can automatically assign a default role to new users:

'tyro' => [
    'assign_default_role' => env('TYRO_LOGIN_ASSIGN_DEFAULT_ROLE', true),
    'default_role_slug' => env('TYRO_LOGIN_DEFAULT_ROLE_SLUG', 'user'),
],

Math Captcha

Add a simple math captcha to your login and/or registration forms to prevent automated submissions:

'captcha' => [
    'enabled_login' => env('TYRO_LOGIN_CAPTCHA_LOGIN', false),
    'enabled_register' => env('TYRO_LOGIN_CAPTCHA_REGISTER', false),
    'label' => 'Security Check',
    'placeholder' => 'Enter the answer',
    'error_message' => 'Incorrect answer. Please try again.',
    'min_number' => 1,
    'max_number' => 10,
],

Login OTP Verification

Add two-factor authentication via email OTP. After entering valid credentials, users receive a one-time code:

'otp' => [
    'enabled' => env('TYRO_LOGIN_OTP_ENABLED', false),
    'length' => 4,           // 4-8 digits
    'expire' => 5,           // minutes
    'max_resend' => 3,
    'resend_cooldown' => 60, // seconds
],

Features:

Beautiful OTP input with individual digit boxes
Configurable code length (4-8 digits)
Resend functionality with cooldown
Cache-based storage (no database required)

Time-Based Two-Factor Authentication (TOTP)

Secure your application with Time-Based One-Time Password (TOTP) two-factor authentication, compatible with apps like Google Authenticator, Authy, and Microsoft Authenticator.

Installation

Run Migrations: This adds two_factor_secret, two_factor_recovery_codes, and two_factor_confirmed_at columns to your users table.
```
php artisan migrate
```

Add Trait to User Model: Add the HasTwoFactorAuth trait to your User model for automatic attribute casting and encryption/decryption (optional). If this trait is not used, Tyro Login will still encrypt sensitive data using Laravel's built-in encryption.

use HasinHayder\TyroLogin\Traits\HasTwoFactorAuth;

class User extends Authenticatable
{
    use HasTwoFactorAuth;
    
    protected function casts(): array
    {
        return [
            'password' => 'hashed',
            'two_factor_confirmed_at' => 'datetime',
        ];
    }
    
    // ...
    
    protected static function booted()
    {
        static::created(function ($user) {
            // Initialize the trait's casts
            $user->initializeHasTwoFactorAuth();
        });
    }
    
    // OR simply rely on the trait's initialize method if using Laravel 10/11 standard boot
}

Note: The trait uses a custom cast EncryptedOrPlaintext to ensure secrets are stored securely.

Configuration

Enable and configure 2FA in config/tyro-login.php:

'two_factor' => [
    // Enable/disable 2FA globally
    'enabled' => env('TYRO_LOGIN_2FA_ENABLED', false),

    // Page titles and subtitles
    'setup_title' => env('TYRO_LOGIN_2FA_SETUP_TITLE', 'Two Factor Authentication'),
    'setup_subtitle' => env('TYRO_LOGIN_2FA_SETUP_SUBTITLE', 'Scan the QR code with your authenticator app.'),
    'challenge_title' => env('TYRO_LOGIN_2FA_CHALLENGE_TITLE', 'Two Factor Authentication'),
    'challenge_subtitle' => env('TYRO_LOGIN_2FA_CHALLENGE_SUBTITLE', 'Enter the code from your authenticator app.'),
    
    // Allow users to skip setup (if false, setup is mandatory)
    'allow_skip' => env('TYRO_LOGIN_2FA_ALLOW_SKIP', false),
],

How it works:

Mandatory Setup: If enabled and allow_skip is false, new users (and existing users without 2FA) are redirected to the setup wizard immediately after login/registration.
Secure Setup: Users must verify a code from their authenticator app to enable 2FA.
Recovery Codes: Upon successful setup, users are shown a set of recovery codes that can be used if they lose access to their device.
Challenge Screen: On subsequent logins, users must provide a TOTP code or a recovery code.
Security: Secrets are encrypted in the database. Users are not fully authenticated until they pass the 2FA challenge.

Debug Mode

Enable debug logging for development:

'debug' => env('TYRO_LOGIN_DEBUG', false),

When enabled, OTP codes, verification URLs, and password reset URLs are logged to storage/logs/laravel.log in masked form.

Email Configuration

Tyro Login sends sleek, minimal HTML emails with a clean design. Each email type can be individually enabled or disabled:

'emails' => [
    // OTP verification email
    'otp' => [
        'enabled' => env('TYRO_LOGIN_EMAIL_OTP', true),
        'subject' => env('TYRO_LOGIN_EMAIL_OTP_SUBJECT', 'Your Verification Code'),
    ],

    // Password reset email
    'password_reset' => [
        'enabled' => env('TYRO_LOGIN_EMAIL_PASSWORD_RESET', true),
        'subject' => env('TYRO_LOGIN_EMAIL_PASSWORD_RESET_SUBJECT', 'Reset Your Password'),
    ],

    // Email verification email
    'verify_email' => [
        'enabled' => env('TYRO_LOGIN_EMAIL_VERIFY', true),
        'subject' => env('TYRO_LOGIN_EMAIL_VERIFY_SUBJECT', 'Verify Your Email Address'),
    ],

    // Welcome email after registration
    'welcome' => [
        'enabled' => env('TYRO_LOGIN_EMAIL_WELCOME', true),
        'subject' => env('TYRO_LOGIN_EMAIL_WELCOME_SUBJECT', null), // Uses default with app name
    ],
],

Available Emails:

OTP Email - Sent when OTP verification is enabled
Password Reset Email - Sent when user requests password reset
Email Verification Email - Sent when email verification is required
Welcome Email - Sent after successful registration (when verification is not required)

Customizing Email Templates:

Publish email templates to customize them:

php artisan tyro-login:publish --emails

Templates will be published to resources/views/vendor/tyro-login/emails/.

Available template variables:

{{ $name }} - User's name
{{ $appName }} - Application name
{{ $otp }} - OTP code (for OTP email)
{{ $resetUrl }} - Password reset URL (for password reset email)
{{ $verificationUrl }} - Verification URL (for verification email)
{{ $loginUrl }} - Login URL (for welcome email)
{{ $expiresIn }} - Expiration time in minutes

Lockout Protection

When enabled, users will be locked out after too many failed login attempts. The lockout state is stored in cache (no database required), and the cache is automatically cleared when the lockout expires.

'lockout' => [
    'enabled' => env('TYRO_LOGIN_LOCKOUT_ENABLED', true),
    'max_attempts' => env('TYRO_LOGIN_LOCKOUT_MAX_ATTEMPTS', 5),
    'duration_minutes' => env('TYRO_LOGIN_LOCKOUT_DURATION', 15),
    'message' => 'Too many failed login attempts. Please try again in :minutes minutes.',
    'title' => 'Account Temporarily Locked',
    'subtitle' => 'For your security, we\'ve temporarily locked your account.',
],

Features:

No database required - uses cache
Configurable number of attempts before lockout
Configurable lockout duration
Customizable lockout page message and title
Automatic cache cleanup when lockout expires
Real-time countdown timer on lockout page

Social Login (OAuth)

Tyro Login supports OAuth authentication using Laravel Socialite. Users can sign in with their social media accounts.

Supported Providers:

Google
Facebook
GitHub
Twitter/X
LinkedIn
Bitbucket
GitLab
Slack

Installation

Install with social login support:

php artisan tyro-login:install --with-social

Or add social login to an existing installation:

composer require laravel/socialite
php artisan vendor:publish --tag=tyro-login-migrations
php artisan migrate

Configuration

Enable Social Login Globally:

TYRO_LOGIN_SOCIAL_ENABLED=true

Enable Desired Providers:

TYRO_LOGIN_SOCIAL_GOOGLE=true
TYRO_LOGIN_SOCIAL_GITHUB=true
TYRO_LOGIN_SOCIAL_FACEBOOK=true

Configure Provider Credentials:

Add credentials to config/services.php:

'google' => [
    'client_id' => env('GOOGLE_CLIENT_ID'),
    'client_secret' => env('GOOGLE_CLIENT_SECRET'),
    'redirect' => env('GOOGLE_REDIRECT_URI'),
],

'github' => [
    'client_id' => env('GITHUB_CLIENT_ID'),
    'client_secret' => env('GITHUB_CLIENT_SECRET'),
    'redirect' => env('GITHUB_REDIRECT_URI'),
],

'facebook' => [
    'client_id' => env('FACEBOOK_CLIENT_ID'),
    'client_secret' => env('FACEBOOK_CLIENT_SECRET'),
    'redirect' => env('FACEBOOK_REDIRECT_URI'),
],

// For Twitter/X (OAuth 2.0)
'twitter' => [
    'client_id' => env('TWITTER_CLIENT_ID'),
    'client_secret' => env('TWITTER_CLIENT_SECRET'),
    'redirect' => env('TWITTER_REDIRECT_URI'),
],

// For LinkedIn (OpenID Connect)
'linkedin-openid' => [
    'client_id' => env('LINKEDIN_CLIENT_ID'),
    'client_secret' => env('LINKEDIN_CLIENT_SECRET'),
    'redirect' => env('LINKEDIN_REDIRECT_URI'),
],

// For Slack (OpenID Connect)
'slack-openid' => [
    'client_id' => env('SLACK_CLIENT_ID'),
    'client_secret' => env('SLACK_CLIENT_SECRET'),
    'redirect' => env('SLACK_REDIRECT_URI'),
],

Add Environment Variables:

# Google
GOOGLE_CLIENT_ID=your-client-id
GOOGLE_CLIENT_SECRET=your-client-secret
GOOGLE_REDIRECT_URI="${APP_URL}/auth/google/callback"

# GitHub
GITHUB_CLIENT_ID=your-client-id
GITHUB_CLIENT_SECRET=your-client-secret
GITHUB_REDIRECT_URI="${APP_URL}/auth/github/callback"

# Facebook
FACEBOOK_CLIENT_ID=your-client-id
FACEBOOK_CLIENT_SECRET=your-client-secret
FACEBOOK_REDIRECT_URI="${APP_URL}/auth/facebook/callback"

# Slack
SLACK_CLIENT_ID=your-client-id
SLACK_CLIENT_SECRET=your-client-secret
SLACK_REDIRECT_URI="${APP_URL}/auth/slack/callback"

Social Login Behavior

'social' => [
    'enabled' => env('TYRO_LOGIN_SOCIAL_ENABLED', false),

    // Link social accounts to existing users (matched by email)
    'link_existing_accounts' => env('TYRO_LOGIN_SOCIAL_LINK_EXISTING', true),

    // Automatically create new users from social login
    'auto_register' => env('TYRO_LOGIN_SOCIAL_AUTO_REGISTER', true),

    // Automatically verify user email after social login/register
    // Social providers confirm email ownership, so we can trust the email
    'auto_verify_email' => env('TYRO_LOGIN_SOCIAL_AUTO_VERIFY_EMAIL', true),

    // Text shown above social buttons
    'divider_text' => env('TYRO_LOGIN_SOCIAL_DIVIDER', 'Or continue with'),
],

How it works:

User clicks a social login button on login/register page
User is redirected to the OAuth provider for authentication
After approval, user is redirected back to your app
If user has linked social account → Log them in
If user email exists and linking is enabled → Link social account and log in
If user doesn't exist and auto-register is enabled → Create new user and log in

Automatic Email Verification:

When users authenticate via social login, their email is automatically marked as verified (if auto_verify_email is enabled). This is because OAuth providers confirm email ownership during the authentication process, so we can trust the email address provided.

Social Accounts Table:

A migration creates the social_accounts table to store:

user_id - Link to your users table
provider - The OAuth provider (google, github, etc.)
provider_user_id - User ID from the provider
provider_email - Email from the provider
provider_avatar - Avatar URL from the provider
access_token / refresh_token - OAuth tokens (encrypted)
token_expires_at - Token expiration time

Customizing Provider Labels and Icons

'social' => [
    'providers' => [
        'google' => [
            'enabled' => true,
            'label' => 'Google',  // Button text
            'icon' => 'google',   // Icon identifier
        ],
        'github' => [
            'enabled' => true,
            'label' => 'GitHub',
            'icon' => 'github',
        ],
    ],
],

Layout Examples

Tyro Login provides 5 stunning layout options to match your application's branding:

1. Centered Layout (Default)

Form appears in the center of the page with a gradient background.

TYRO_LOGIN_LAYOUT=centered

2. Split-Left Layout

Two-column layout with a background image on the left and the form on the right.

TYRO_LOGIN_LAYOUT=split-left
TYRO_LOGIN_BACKGROUND_IMAGE=https://images.unsplash.com/photo-1618005182384-a83a8bd57fbe?w=1920&q=80

3. Split-Right Layout

Two-column layout with the form on the left and a background image on the right.

TYRO_LOGIN_LAYOUT=split-right
TYRO_LOGIN_BACKGROUND_IMAGE=https://images.unsplash.com/photo-1618005182384-a83a8bd57fbe?w=1920&q=80

4. Fullscreen Layout

Full-screen background image with a glassmorphism form overlay featuring frosted glass effect and backdrop blur.

TYRO_LOGIN_LAYOUT=fullscreen
TYRO_LOGIN_BACKGROUND_IMAGE=https://images.unsplash.com/photo-1618005182384-a83a8bd57fbe?w=1920&q=80

5. Card Layout

Floating card design with subtle radial gradient background patterns and smooth hover animations.

TYRO_LOGIN_LAYOUT=card

All layouts support:

Dark and light themes
Fully responsive design
Customizable branding
All authentication features (OTP, captcha, email verification, etc.)

Customization

Publishing Views

To customize the views, publish them to your application:

php artisan tyro-login:publish --views

Views will be published to resources/views/vendor/tyro-login/.

Publishing Email Templates

To customize the email templates:

php artisan tyro-login:publish --emails

Email templates will be published to resources/views/vendor/tyro-login/emails/.

Publishing Everything

php artisan tyro-login:publish

This publishes config, views, email templates, and assets.

Theme Customization (shadcn Variables)

Tyro Login uses shadcn/ui CSS variables for theming, making it easy to customize colors and integrate with shadcn-based projects.

Publishing Theme Files

Publish the theme variables to customize the look and feel:

# Publish only theme variables (recommended for color customization)
php artisan tyro-login:publish-style --theme-only

# Or publish complete styles (theme + component styles)
php artisan tyro-login:publish-style

Theme files will be published to resources/views/vendor/tyro-login/partials/.

Visual Theme Editing with tweakcn (free)

The easiest way to customize your theme is using tweakcn.com:

Visit tweakcn.com
Use the visual editor to create your perfect color palette
Copy the generated CSS variables
Publish your theme: php artisan tyro-login:publish-style --theme-only
Paste the variables into resources/views/vendor/tyro-login/partials/shadcn-theme.blade.php

Theme File Structure

After publishing, your theme structure will be:

resources/views/vendor/tyro-login/partials/
├── shadcn-theme.blade.php  # Theme variables (edit this!)
└── styles.blade.php        # Component styles (includes theme)

The shadcn-theme.blade.php file contains only CSS variables, making it safe to edit without breaking component styles.

Artisan Commands

Tyro Login provides several artisan commands:

Command	Description
`php artisan tyro-login:install`	Install the package and publish configuration
`php artisan tyro-login:install --with-social`	Install with social login (Laravel Socialite) support
`php artisan tyro-login:publish`	Publish config, views, email templates, and assets
`php artisan tyro-login:publish --emails`	Publish only email templates
`php artisan tyro-login:publish-style`	Publish styles (theme + components)
`php artisan tyro-login:publish-style --theme-only`	Publish only theme variables
`php artisan tyro-login:verify-user`	Mark a user's email as verified
`php artisan tyro-login:unverify-user`	Remove email verification from a user
`php artisan tyro-login:version`	Display the current Tyro Login version
`php artisan tyro-login:doc`	Open the documentation in your browser
`php artisan tyro-login:star`	Open GitHub repository to star the project

User Verification Commands

Tyro Login provides commands to manually verify or unverify user email addresses.

Verify a single user by email:

php artisan tyro-login:verify-user john@example.com

Verify a single user by ID:

php artisan tyro-login:verify-user 123

Verify all unverified users:

php artisan tyro-login:verify-user --all

Unverify a single user:

php artisan tyro-login:unverify-user john@example.com

Unverify all verified users:

php artisan tyro-login:unverify-user --all

Reset 2FA for a user:

Currently locked out users or those who lost their device/codes can have their 2FA reset by an admin:

php artisan tyro-login:reset-2fa user@example.com
# OR
php artisan tyro-login:reset-2fa 1

These commands are useful for:

Manually verifying users during development or testing
Bulk verification of imported users
Resetting verification status for testing email flows

Routes

Tyro Login registers the following routes:

Method	URI	Name	Description
GET	`/login`	`tyro-login.login`	Show login form
POST	`/login`	`tyro-login.login.submit`	Handle login
GET	`/register`	`tyro-login.register`	Show registration form
POST	`/register`	`tyro-login.register.submit`	Handle registration
GET/POST	`/logout`	`tyro-login.logout`	Handle logout
GET	`/lockout`	`tyro-login.lockout`	Show lockout page
GET	`/email/verify`	`tyro-login.verification.notice`	Show verification notice
GET	`/email/not-verified`	`tyro-login.verification.not-verified`	Show unverified email page
GET	`/email/verify/{token}`	`tyro-login.verification.verify`	Verify email
POST	`/email/resend`	`tyro-login.verification.resend`	Resend verification email
GET	`/forgot-password`	`tyro-login.password.request`	Show forgot password form
POST	`/forgot-password`	`tyro-login.password.email`	Send reset link
GET	`/reset-password/{token}`	`tyro-login.password.reset`	Show reset form
POST	`/reset-password`	`tyro-login.password.update`	Reset password
GET	`/otp/verify`	`tyro-login.otp.verify`	Show OTP form
POST	`/otp/verify`	`tyro-login.otp.submit`	Verify OTP
POST	`/otp/resend`	`tyro-login.otp.resend`	Resend OTP
GET	`/otp/cancel`	`tyro-login.otp.cancel`	Cancel OTP verification
GET	`/auth/{provider}/redirect`	`tyro-login.social.redirect`	Redirect to OAuth provider
GET	`/auth/{provider}/callback`	`tyro-login.social.callback`	Handle OAuth callback

Customizing Route Prefix

'routes' => [
    'prefix' => env('TYRO_LOGIN_ROUTE_PREFIX', 'auth'),
    // Routes will be: /auth/login, /auth/register, etc.
],

Security Features

Tyro Login implements industry-standard security practices:

Encrypted Data Storage
- OAuth access and refresh tokens encrypted at rest using Laravel's encryption
- Custom EncryptedOrPlaintext cast for seamless migration
- Protects against database compromise
Cryptographically Secure Random
- OTP codes generated using random_int() (cryptographically secure)
- Eliminates predictable patterns and statistical analysis attacks
Session Security
- Session regeneration after logout in OTP flow prevents fixation attacks
- Session regeneration on successful login prevents session fixation
- Secure session handling throughout authentication flows
CSRF Protection
- All forms include CSRF tokens
- Logout requires POST request with CSRF token
- Protection against cross-site request forgery attacks
Lockout Protection
- Temporarily lock accounts after failed attempts (cache-based, no database)
- Configurable attempts and duration
- Automatic cache cleanup when lockout expires
Email Verification
- Optional email verification for new registrations
- Secure signed URLs with expiration
- Automatic verification via social login
Secure Password Reset
- Time-limited, signed URLs for password reset
- Tokens stored in cache with expiration
- Automatic token cleanup
Password Security
- Laravel's bcrypt/argon2 hashing
- Configurable minimum password length
- Password confirmation requirement
Privacy-Safe Debug Logging
- Email addresses masked in logs (e.g., use***@example.com)
- No security tokens or sensitive URLs logged
- GDPR/CCPA compliant logging
- Structured logging format
Input Validation
- Server-side validation with proper error messages
- Protection against malicious input
- Email format validation

Integration with Tyro

Tyro Login integrates seamlessly with the Tyro package:

When a new user registers, Tyro Login can automatically assign a default role
Configure the default role slug in your config
Ensure your User model uses the HasTyroRoles trait

// In your User model
use HasinHayder\Tyro\Concerns\HasTyroRoles;

class User extends Authenticatable
{
    use HasTyroRoles;
}

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security-related issues, please email hasin@hasin.me instead of using the issue tracker.

License

The MIT License (MIT). Please see License File for more information.

Credits

Hasin Hayder

Made with love for the Laravel community by Hasin Hayder

hasinhayder / tyro-login

Maintainers

Details

README

Features

Requirements

Installation

Configuration

Layout Options

Branding

Redirects

Registration Settings

Email Verification

Password Reset

Tyro Integration

Math Captcha

Login OTP Verification

Time-Based Two-Factor Authentication (TOTP)

Installation

Configuration

Debug Mode

Email Configuration

Lockout Protection

Social Login (OAuth)

Installation

Configuration

Social Login Behavior

Customizing Provider Labels and Icons

Layout Examples

1. Centered Layout (Default)

2. Split-Left Layout

3. Split-Right Layout

4. Fullscreen Layout

5. Card Layout

Customization

Publishing Views

Publishing Email Templates

Publishing Everything

Theme Customization (shadcn Variables)

Publishing Theme Files

Visual Theme Editing with tweakcn (free)

Theme File Structure

Artisan Commands

User Verification Commands

Routes

Customizing Route Prefix

Security Features

Integration with Tyro

Changelog

Contributing

Security

License

Credits