Artisan commands

Three commands: one to set the package up, one to scaffold Inertia components, one to keep the token table tidy.

passwordless:install

The setup wizard. Covers everything in one interactive session — publishing config, publishing and running migrations, choosing your flows, scaffolding views or Inertia components, and writing the resulting .env keys.

php artisan passwordless:install

It will not clobber existing files without --force, so re-running it to change an answer is safe. The one thing it cannot do for you is add the trait to your User model.

Full walkthrough on the Installation page.

passwordless:install-inertia

Adds Inertia component stubs to an app that is already installed. Reads package.json to detect the framework, or takes it explicitly.

# Auto-detect from package.json
php artisan passwordless:install-inertia

# Explicit framework
php artisan passwordless:install-inertia --framework=vue
php artisan passwordless:install-inertia --framework=react
php artisan passwordless:install-inertia --framework=svelte

# Overwrite existing stubs
php artisan passwordless:install-inertia --force

Published files, Vue shown:

resources/js/Pages/Auth/MagicLinkRequest.vue
resources/js/Pages/Auth/MagicLinkSent.vue
resources/js/Pages/Auth/LoginCodeRequest.vue
resources/js/Pages/Auth/LoginCodeVerify.vue

After writing them it prints the config snippet to paste into config/passwordless.php. See Inertia.

passwordless:purge

Remove spent tokens from passwordless_tokens.

# Purge everything expired or used (default)
php artisan passwordless:purge

# Only expired tokens
php artisan passwordless:purge --expired

# Only used tokens
php artisan passwordless:purge --used

# Keep a retention window — only touch rows at least 7 days old
php artisan passwordless:purge --days=7

With neither --expired nor --used (or with both), the default is "expired or used". --days narrows whichever set you selected; it does not select on its own.

The command reports what it removed:

Purged 128 passwordless token(s).

Schedule it

// routes/console.php
use Illuminate\Support\Facades\Schedule;

Schedule::command('passwordless:purge')->daily();

Or keep a week of history rather than deleting everything spent:

Schedule::command('passwordless:purge --days=7')->daily();