PasskeySetupScreen
Component Detail
Description
Guides users through passkey registration during onboarding or from account settings. Renders platform-native WebAuthn prompts and communicates registration success or failure with accessible feedback. Handles edge cases such as unsupported devices and prompts the user to fall back to email/password login when necessary.
passkey-setup-screen
Sources & reasoning
Passkeys are not mentioned in the source document. The feature appears in the authoritative blueprint with target_release v1.1. No phase evidence exists in source docs, so blueprint assignment is used directly. v1.1 aligns with Phase 3 ordinal position. The feature is a logical evolution of the biometric-login foundation and industry direction for passwordless auth on iOS/Android.
No source references — this artifact was included based on reasoning alone (see above).
Responsibilities
- Initiate passkey registration flow by requesting a challenge from PasskeyAuthService
- Invoke the browser or platform WebAuthn credential creation API with the challenge
- Display registration success confirmation and update the UI to reflect saved passkey
- Surface actionable error messages for unsupported devices, cancelled prompts, or server errors
- Provide accessible fallback option linking to email/password registration
Interfaces
startRegistration(): Promise<void>
handleRegistrationSuccess(credential: PublicKeyCredential): void
handleRegistrationError(error: Error): void
navigateToFallback(): void