Skip to main content
The mobile onboarding (apps/mobile/lib/features/onboarding) replaces the earlier five-slide carousel. It uses the Sorbet design: core/ui components, SorbetTokens colours and the onboarding illustration scenes in lib/core/ui/kit/illustration/illustration_scenes_onboarding.dart. It opens above the app shell, never inside it. The flow has three steps and a closing screen:
  1. Make it yours: photo (the existing avatar picker and upload), display name (the profile API), language (EN or VI), appearance (Light, Dark or Auto) and Product news by email.
  2. Set up your space: an open workspace invite with Join, then Just me (keep the personal workspace) or With my team (create a workspace by name through the same create action the workspace picker uses).
  3. What brings you here?: Calendar, Tasks, Chat, Education, Finance and Mira tiles, multi-select.
  4. You’re all set: Add your first task, Connect your calendar, Turn on notifications, and Open Tuturuuu.

Decisions

Regression coverage

  • test/features/onboarding/onboarding_gate_test.dart: once per account, existing accounts on first run, per-user outcomes, deep-link deferral.
  • test/core/router/app_router_onboarding_test.dart: signed out, MFA, add-account mode, account switching, no workspace, exempt routes, pending deep link, already completed or skipped, a second account, safe return targets.
  • test/features/onboarding/onboarding_page_test.dart: each step, skip at every step, replay records nothing, product news off and disabled, name save and failure, workspace create and limit, invite join, Education and General modes, goal sync, next-step links.
  • test/features/onboarding/onboarding_design_render_test.dart: design renders of the four screens at phone and tablet, light and dark, plus Vietnamese step 1.