Sign In with Email and Password
Peer mentors need a reliable, straightforward email and password login flow as the foundational authentication method. The login screen must present a clean form with email and password fields, real-time inline validation, and a clear submit action. The form should be keyboard-aware so the input fields are never obscured by the software keyboard, particularly important on smaller devices. Upon successful authentication, the user is routed to their role-specific home screen. Failed authentication must surface a clear, plain-language error without exposing security details.
User Story
Acceptance Criteria
- Given the app is launched and no session exists, When the user navigates past org selection, Then the login screen is displayed with email and password fields and a sign-in button
- Given the login screen is visible, When the user taps the password field, Then the keyboard appears and the form scrolls so the password field remains visible above the keyboard
- Given valid credentials are entered, When the user taps sign in, Then the app authenticates via Supabase Auth and navigates to the peer mentor home screen within 3 seconds
- Given invalid credentials are entered, When the user taps sign in, Then a clear error message is shown (e.g. 'Incorrect email or password') without revealing which field is wrong
- Given the email field is empty or malformed, When the user taps sign in, Then inline validation highlights the email field with a descriptive error before any network request is made
- Given a successful login, When the session is established, Then the auth token is securely stored so subsequent app launches skip the login screen
Business Value
Email and password login is the baseline authentication method that enables every peer mentor to access the platform. Without this, no other feature is reachable. It directly unblocks activity registration, reporting, and contact management — the core value of the app. A frictionless login experience reduces dropout at the entry point and sets the tone for the overall quality of the product.
Components
- Login Screen ui
- Login Form ui
- Login Form BLoC service
- Credential Validator service
- Authentication Service service
- Authentication Repository data
- Supabase Auth Client infrastructure
- Keyboard-Aware Layout Utility infrastructure
- Authentication Session Manager service
- Auth Token Store data
- Secure Storage Adapter infrastructure