Create Your First User

This guide walks through the first successful auth flow in a local Seamless Auth stack.

By the end, you should have:

a created user
a completed passwordless verification flow
an authenticated session
a working mental model of what happened in the stack

Before You Start

Make sure:

your local stack is running
the web app is available at http://localhost:5173
you are using the generated starter project or an equivalent local setup

Step 1: Open The App

Navigate to:

http://localhost:5173

You should see the starter UI.

Seamless Auth starter UI — Starter UI before authentication

Step 2: Start Registration

In the starter form:

enter an email address
optionally enter a phone number
submit the flow

Registration starts with just an email. The system detects that the user does not already exist and moves into email verification. (A phone number is optional and can be added and verified later.)

Step 3: Complete Verification

Registration sends a one-time code to the email address. In local development:

OTP values are returned in the dev delivery payload (visible in logs or dev-oriented messaging)
enter the code to verify the email
on a device that supports passkeys, you are then prompted to register one

Once the email code is verified: