v3.0: Livewire 4 migration and optional passkeys

.gitignore

@@ -1,3 +1,4 @@
 vendor/
 node_modules/
 .DS_Store
+.idea/

CHANGELOG.md

@@ -1,7 +1,31 @@
 # Changelog
 
-All notable changes to `auth` will be documented in this file
+## 3.0.0 - Unreleased
 
-## 1.0.0 - 201X-XX-XX
+### Breaking Changes
 
-- initial release
+- Requires Livewire 4 (`^4.0`). Livewire 3 is no longer supported.
+- Removed `livewire/volt` and `laravel/folio` dependencies.
+- Auth pages are now Livewire 4 single-file components registered via `Livewire::addLocation()`.
+- Minimum PHP version is now 8.2.
+- Minimum Laravel version is now 12 (Laravel 13 is also supported).
+- Published auth assets must be republished after upgrading. See [UPGRADE.md](UPGRADE.md).
+
+### Added
+
+- Optional passkey authentication via `laravel/passkeys`.
+- New `/auth/setup/passkeys` configuration screen to enable or disable passkey sign-in.
+- `enable_passkeys` setting in `config/devdojo/auth/settings.php`.
+- `auth:passkeys-config` publish tag for passkeys configuration.
+
+### Changed
+
+- Migrated all authentication pages from Volt/Folio to Livewire 4 SFCs.
+- `Devdojo\Auth\Models\User` now implements `PasskeyUser` and uses `PasskeyAuthenticatable`.
+- Setup preview modal now uses `fixed` positioning so it renders above the settings panel.
+- Setup pages use Livewire 4 event syntax (`$event.target`) for toggles and inputs.
+
+### Fixed
+
+- Setup preview modal no longer appears behind the settings page when published assets are current.
+- PHPStan configuration and `User` model property annotations.

README.md

@@ -85,6 +85,31 @@ class User extends Devdojo\Auth\Models\User
 }
 ```
 
+## (Optional) Enabling Passkeys
+
+Passkeys are disabled by default. To enable passwordless sign-in:
+
+1. Publish the passkeys config:
+
+```
+php artisan vendor:publish --tag=auth:passkeys-config
+```
+
+2. Publish and run the passkeys migration:
+
+```
+php artisan vendor:publish --tag=passkeys-migrations --provider="Laravel\Passkeys\PasskeysServiceProvider"
+php artisan migrate
+```
+
+3. Visit `/auth/setup/passkeys` and enable **Passkey Sign-In**.
+
+Your `App\Models\User` should extend `Devdojo\Auth\Models\User`, which already includes the required `PasskeyAuthenticatable` trait.
+
+## Upgrading from 2.x
+
+See [UPGRADE.md](UPGRADE.md) for the v3.0 migration guide.
+
 ## License
 
 The DevDojo Auth package is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).

UPGRADE.md

@@ -0,0 +1,96 @@
+# Upgrading to 3.0
+
+Version 3.0 is a breaking release. Plan for dependency updates, asset republishing, and page customizations to move from Volt/Folio to Livewire 4.
+
+## Requirements
+
+- PHP 8.2+
+- Laravel 12 or 13
+- Livewire 4 (`^4.0`)
+
+## Upgrade steps
+
+### 1. Update dependencies
+
+```bash
+composer require devdojo/auth:^3.0 livewire/livewire:^4.0
+```
+
+Volt and Folio are no longer required by this package. You may keep them in your app for unrelated features.
+
+`laravel/passkeys` is included as a dependency. Passkey UI remains disabled until you enable it in `/auth/setup/passkeys`.
+
+### 2. Republish package files
+
+```bash
+php artisan vendor:publish --tag=auth:config
+php artisan vendor:publish --tag=auth:assets --force
+php artisan vendor:publish --tag=auth:migrations
+php artisan migrate
+```
+
+Republishing `auth:assets` is required after upgrading. The setup UI uses Tailwind v4 class names in `public/auth/build/assets/styles.css`.
+
+### 3. Update customized auth pages
+
+Auth screens are now Livewire 4 single-file components registered from the package via `Livewire::addLocation()`.
+
+If you previously customized Volt/Folio pages under `resources/views/pages/auth/`, move them to the same paths and register an additional Livewire location in your app service provider:
+
+```php
+use Livewire\Livewire;
+
+Livewire::addLocation(viewPath: resource_path('views/pages'));
+```
+
+Your application views take precedence when registered after the package provider.
+
+To override Blade components without copying entire pages, publish to `resources/views/vendor/auth/`.
+
+If your customized setup pages use Livewire event handlers, update Livewire 3 syntax to Livewire 4:
+
+```blade
+{{-- Before (Livewire 3) --}}
+wire:change="update('key', $el.checked)"
+wire:blur="update('key', $el.value)"
+
+{{-- After (Livewire 4) --}}
+wire:change="update('key', $event.target.checked)"
+wire:blur="update('key', $event.target.value)"
+```
+
+Package setup pages already use `$event.target`. Alpine `$el` references inside `x-data` blocks are unchanged.
+
+### 4. Optional: enable passkeys
+
+```bash
+php artisan vendor:publish --tag=auth:passkeys-config
+php artisan vendor:publish --tag=passkeys-migrations --provider="Laravel\Passkeys\PasskeysServiceProvider"
+php artisan migrate
+```
+
+Then visit `/auth/setup/passkeys` and enable **Passkey Sign-In**.
+
+Your `App\Models\User` should extend `Devdojo\Auth\Models\User`, which already includes `PasskeyAuthenticatable`.
+
+### 5. Clear caches
+
+```bash
+php artisan config:clear
+php artisan view:clear
+php artisan route:clear
+```
+
+## What changed
+
+| Area | v2.x | v3.0 |
+| --- | --- | --- |
+| Page routing | Volt + Folio | Livewire 4 SFCs |
+| Livewire | 3.x | 4.x |
+| Passkeys | Not included | Optional via `enable_passkeys` |
+| Setup preview modal | `absolute` + custom z-index | `fixed` + standard z-index utilities |
+| Setup event handlers | `$el.checked` / `$el.value` | `$event.target.checked` / `$event.target.value` |
+
+## Need help?
+
+Open a discussion at [devdojo.com/questions](https://devdojo.com/questions) or review the [documentation](https://devdojo.com/auth/docs).

composer.json

@@ -16,44 +16,44 @@
         }
     ],
     "require": {
-        "php": "^7.4|^8.0|^8.1|^8.2|^8.3|^8.4",
-        "illuminate/support": "^8.0|^9.0|^10.0|^11.0|^12.0|^13.0",
-        "laravel/folio": "^1.0",
-        "livewire/livewire": "^3.0|^4.0",
-        "livewire/volt": "^1.10",
+        "php": "^8.2|^8.3|^8.4|^8.5",
+        "bacon/bacon-qr-code": "^3.0",
+        "calebporzio/sushi": "^2.5",
         "codeat3/blade-phosphor-icons": "^2.0",
         "devdojo/config-writer": "^0.0.7",
+        "illuminate/support": "^12.0|^13.0",
+        "laravel/passkeys": "^0.2.1",
         "laravel/socialite": "^5.0",
-        "calebporzio/sushi": "^2.5",
-        "pragmarx/google2fa": "^8.0|^9.0",
-        "bacon/bacon-qr-code": "^3.0"
+        "livewire/livewire": "^4.0",
+        "pragmarx/google2fa": "^9.0"
     },
     "require-dev": {
         "laravel/pint": "^1.15",
-        "orchestra/testbench": "^9.0",
-        "pestphp/pest": "^3.7",
-        "pestphp/pest-plugin-laravel": "^3.1",
-        "larastan/larastan": "^2.0",
-        "phpstan/phpstan": "^1.11",
+        "orchestra/testbench": "^10.0|^11.0",
+        "pestphp/pest": "^3.7|^4.0",
+        "pestphp/pest-plugin-laravel": "^3.1|^4.0",
+        "larastan/larastan": "^3.0",
+        "phpstan/phpstan": "^2.0",
         "laravel/dusk": "^8.2",
         "protonemedia/laravel-dusk-fakes": "^1.6",
         "alebatistella/duskapiconf": "^1.2"
     },
     "autoload": {
         "psr-4": {
             "Devdojo\\Auth\\": "src",
-            "Devdojo\\Auth\\Tests\\": "tests"
+            "Devdojo\\Auth\\Tests\\": "tests",
+            "Tests\\": "tests"
         }
     },
     "autoload-dev": {
         "psr-4": {
-            "Devdojo\\Auth\\Tests\\": "tests"
+            "Devdojo\\Auth\\Tests\\": "tests",
+            "Tests\\": "tests"
         }
     },
     "scripts": {
-        "test": "vendor/bin/phpunit",
-        "test-coverage": "vendor/bin/phpunit --coverage-html coverage"
-
+        "test": "vendor/bin/pest",
+        "test-coverage": "vendor/bin/pest --coverage"
     },
     "config": {
         "sort-packages": true,