Biometric Prompt Widget
Component Detail
User Interface
low complexity
mobile
1
Dependencies
0
Dependents
0
Entities
0
Integrations
Description
Flutter widget that triggers the platform biometric authentication dialog using the local_auth package. Renders a prompt screen with a scan icon, a fallback 'Use Password' link, and status feedback (success, failure, locked-out). Handles both Face ID on iOS and fingerprint on Android through a unified surface.
biometric-prompt-widget
Responsibilities
- Invoke local_auth authenticate() with platform-appropriate biometric types
- Display biometric scan prompt with accessible labels and sufficient touch targets
- Show error states for failed, cancelled, or locked-out biometric attempts
- Offer full-credential fallback navigation when biometric is unavailable or revoked
Interfaces
onSuccess() → triggers token refresh via BiometricAuthService
onFallback() → navigates to Login Screen
onError(BiometricError) → renders inline error message
checkAvailability() → returns canAuthenticate status