Track and Resume Onboarding Progress
New peer mentors go through an onboarding flow after their first organization selection. This may include confirming their identity, reviewing their assigned role, and completing any organization-required steps. The onboarding progress indicator shows which steps have been completed and which remain. The onboarding state is persisted in secure storage so that if the user closes the app or loses connectivity, they can resume from where they left off. This is particularly important given the accessibility requirements — users with cognitive challenges need clear, linear progress cues and should not be forced to restart if interrupted.
User Story
Acceptance Criteria
- Given a peer mentor begins the onboarding flow, when they view each screen, then a progress indicator shows their current step position and total number of steps
- Given a peer mentor closes the app mid-onboarding, when they reopen the app and authenticate, then they are returned to the step they left off rather than the beginning of onboarding
- Given a peer mentor completes all onboarding steps, when the last step is confirmed, then the onboarding flow is marked complete and they are routed to the main home screen
- Given the onboarding flow is in progress, when the peer mentor navigates back, then they can return to a previous step without losing data already entered in later steps
- Given the app is in accessibility mode with a screen reader active, when the progress indicator updates, then a live region announcement informs the user which step they are on
Business Value
Workshop participants emphasized gradual digitalization and low cognitive load as core principles. A resumable onboarding flow directly supports users with motor, cognitive, or situational limitations who may not complete all steps in one sitting. It also increases completion rates for the onboarding flow, which is a prerequisite for peer mentors being able to use the full app, ultimately improving data quality for the organizations.
Components
- Onboarding Progress Indicator ui
- Tenant Context Service service
- Tenant Session Store data
- Secure Storage Adapter infrastructure
- Wizard Progress Indicator ui
- Wizard State Manager service
- Wizard Draft Repository data
- Live Region Announcer ui