Family Design System · Patterns / Auth Flow
← Showcase Icons Errors Empty Layout v0.3.0-rc.6

Authentication Flow

Eight canonical auth states forming the complete sign-in / sign-up / recovery flow. Every screen uses the same auth-card anatomy (icon glyph → title → subtitle → form → primary CTA → footer link), so users learn the layout once and recognize it across all states.

The flow

Sign in
2FA challenge
App ✓
|
Sign up
Verify email
App ✓
|
Forgot password
Reset link sent
New password
Sign in

Usage rules

1. Auth-card anatomy (same for every state)

2. Field rules

FieldRules
emailAlways type="email" with autocomplete="email". Validate format on blur, not keystroke.
password (sign-in)Single field. autocomplete="current-password". Show/hide toggle. No strength meter on sign-in (it's discouraging).
password (sign-up / reset)autocomplete="new-password". Strength meter required. Requirements shown as hint, validated on blur.
code (2FA / OTP)Single 6-digit input. inputmode="numeric". autocomplete="one-time-code" (browsers offer SMS auto-fill on iOS). Auto-submit on 6th digit.
terms (sign-up only)Required checkbox. Default unchecked. Link out to terms page in new tab.

3. Per-brand voice

StatePerpetualsBarriersUpsideOnly
Sign-in titleWelcome backSign inWelcome back
Sign-up titleCreate your accountOpen an accountJoin UpsideOnly
Subtitle toneWarm-professionalDirect-factualEncouraging-clear
Forgot CTASend reset linkSend reset linkSend me a link
2FA subtitleWe sent a 6-digit code to your phoneEnter the 6-digit code from your authenticatorWe texted a code to (***) ***-7421

4. Don't

5. Accessibility