Thank you for considering contributing to this package! Please take a moment to review these guidelines before submitting a pull request.

• PHP 8.2+
• Composer

git clone https://github.com/ghostcompiler/laravel-auth.git
cd laravel-auth
composer install

# Run the full test suite
composer test

# Run only the Unit suite
vendor/bin/phpunit --testsuite Unit

# Run only the Feature suite
vendor/bin/phpunit --testsuite Feature

All contributions must pass the following checks:

# Static analysis (PHPStan level 5)
composer analyse

# Type checking (Psalm level 5)
composer types

# Code style check (no auto-fix)
composer lint

# Auto-fix code style
composer format

# Rector modernisation (dry run)
composer refactor

# Security audit
composer audit --no-dev

Before submitting, please confirm:

• All existing tests pass (composer test)
• New tests are added for any new behaviour
• PHPStan passes without new suppression comments
• Psalm passes without new suppression annotations
• Pint reports no violations (composer lint)
• CHANGELOG.md entry added under [Unreleased]
• Documentation in README.md is updated if public API changed

Please do not open a public GitHub issue for security vulnerabilities. See SECURITY.md for the private disclosure process.