Receive Plain-Language Error Feedback on Login Failure
When authentication fails — whether due to wrong credentials, network issues, or a locked account — the peer mentor must receive immediate, understandable feedback. Error messages must be written in plain language (no technical jargon), must not expose security details (e.g. must not confirm whether the email exists), and must guide the user toward a resolution. Network errors must be distinguished from credential errors. The error must be accessible to screen readers via a live region announcement.
User Story
Acceptance Criteria
- Given incorrect credentials are submitted, When authentication fails, Then the message 'Incorrect email or password. Please try again.' is displayed prominently below the form
- Given a network timeout occurs during login, When the request fails, Then the message 'Unable to connect. Check your internet connection and try again.' is shown
- Given a screen reader is active and an error appears, When the error is rendered, Then the screen reader announces the error text automatically without requiring the user to navigate to it
- Given an error message is displayed, When the user begins editing the email or password field, Then the error message is cleared so the user is not confused by stale feedback
- Given three consecutive failed login attempts, When the fourth attempt is made, Then the UI does not lock the user out locally but communicates any server-side lockout message in plain language
Business Value
Clear error feedback is critical for peer mentors who include users with cognitive disabilities, low digital literacy, and older adults. Confusing or technical error messages lead to users abandoning the app or requiring coordinator support to log in. Plain-language errors reduce support burden, increase self-service resolution, and align with the universal design mandate shared by all participating organisations.
Components
- Login Screen ui
- Login Form ui
- Login Form BLoC service
- Credential Validator service
- Authentication Service service
- Supabase Auth Client infrastructure
- Plain Language Error Display ui
- Live Region Announcer ui
Dependencies
- Sign In with Email and Password critical