Complete Onboarding Progress Tracking During First-Time Org Selection
First-time users who have just authenticated via BankID or Vipps are entering the app for the first time. The onboarding progress indicator (668-onboarding-progress-indicator) visually communicates where organization selection fits in the overall onboarding flow (e.g., Step 2 of 3: Choose your organization). This reduces drop-off during first-time setup by giving users a sense of progress and setting expectations about what comes next. The indicator is only shown during the initial onboarding flow, not on subsequent logins where the user goes directly to the org selection or is auto-redirected based on persisted preference.
User Story
Audience Summaries
First-time user activation is the most critical conversion funnel in a peer support platform — if a volunteer drops off during onboarding, they are unlikely to return. This story addresses a specific drop-off risk at the organization selection step by showing a progress indicator (e.g., 'Step 2 of 3: Choose your organization') that reassures users they are nearly done with setup. NHF and Blindeforbundet explicitly serve digitally less-confident populations — stroke survivors and visually impaired users — for whom ambiguity during setup is a significant barrier. Reducing first-session drop-off directly increases the active peer mentor count, which is the platform's primary pilot success metric.
This feature costs minimal development effort but has measurable impact on onboarding completion rates and long-term volunteer retention.
This story depends on story-organization-selection-screen-peer-mentor-001 and is scoped to first-time users only, requiring a reliable mechanism to distinguish new users (just completed BankID/Vipps auth) from returning users with persisted org preferences. The onboarding progress indicator component (668-onboarding-progress-indicator) must be conditionally rendered based on session state. Acceptance criteria include four scenarios: first-time user sees the indicator, returning user does not, indicator updates on step completion, and accessible announcement via VoiceOver. Accessibility testing with VoiceOver is a hard requirement given the target user population.
The story is medium priority and medium complexity — delivery risk is low but QA must cover the conditional display logic thoroughly across both new and returning user paths.
The onboarding progress indicator (668-onboarding-progress-indicator) must be conditionally rendered based on whether the current session is a first-time onboarding flow. This likely requires a session or navigation state flag set at authentication completion (BankID/Vipps callback) and cleared once the user completes org selection and proceeds. The component must receive the current step index and total step count as props and update them reactively when the user selects an org. Accessibility is a hard requirement: the indicator must render with appropriate ARIA attributes (e.g., aria-label or aria-live) so VoiceOver announces 'Step 2 of 3, Choose your organization'.
Edge cases: persisted org preference auto-redirect must bypass the indicator entirely. Unit tests should cover first-time vs returning user branching, step update on selection, and ARIA attribute correctness.
Acceptance Criteria
- Given I am a first-time user who has just completed BankID or Vipps authentication, When the org selection screen appears, Then an onboarding progress indicator is visible showing my current step in the setup flow
- Given I am a returning user with a previously persisted org selection, When I open the app and reach the org selection screen, Then no onboarding progress indicator is shown
- Given the onboarding progress indicator is visible, When I select an organization and proceed, Then the indicator updates to reflect completion of this step before navigating forward
- Given the onboarding progress indicator is displayed, When a screen reader (VoiceOver) reads the screen, Then the progress indicator announces the current step and total steps in accessible text (e.g., 'Step 2 of 3, Choose your organization')
Business Value
All three workshop organizations agreed on incremental rollout and a gentle onboarding experience — users should never feel lost. A progress indicator during first-time organization selection reduces anxiety and abandonment for digitally less-confident users, a population explicitly called out by NHF (stroke survivors) and Blindeforbundet (visually impaired users). Reducing first-session drop-off directly increases the number of active peer mentors in the system, which is the platform's core success metric.
Components
- Onboarding Progress Indicator ui
- Tenant Context Service service
- Organization Selection Service service
- Wizard Progress Indicator ui
- Live Region Announcer ui
- Accessibility Live Region Announcer infrastructure