Project

General

Profile

Actions

Feature #36

closed
VJ

Epic #20: Client design adaptation

Support configurable onboarding flows through language selection

Feature #36: Support configurable onboarding flows through language selection

Added by Vince Jurić 23 days ago. Updated 21 days ago.

Status:
Done
Priority:
Normal
Assignee:
-
Start date:
Due date:
% Done:

0%

Estimated time:

Description

Imported from GitHub issue 283.
Source milestone: Milestone 3.
Source labels: enhancement, ready-for-agent.
Original state: open.

What to build

Deliver the first end-to-end flow through a small app-owned onboarding coordinator: select and confirm a language, then enter the app when no further flow is eligible. Define flows in code using stable flow IDs, revisions, ordered stable step IDs, eligibility and skip/completion policies. Support dedicated screens as well as future shared introduction screens without hardcoding a screen count.

Update the domain documentation to replace the language-only restriction with the approved extensible model. Keep locale preferences separate from per-flow progress. This is an AFK slice.

Acceptance criteria

  • Startup resolves local preferences/progress before choosing onboarding or the main app; no transient main-app flash occurs.
  • The coordinator runs the language-selection flow for users without a saved preference and enters the app when no eligible flow remains.
  • Language selection matches the Figma row/separator/selected-tick layout (node 200:4297), reusing existing typography, tokens and controls, with a safe bottom Continue action.
  • Serbian Latin is listed before English. English-compatible device locales preselect English; other device locales preselect Serbian Latin. Selection immediately previews localised copy; explicit Continue saves the preference.
  • Retain the documented localised title/body preview rather than replacing it with Figma's static bilingual paragraph. Preserve language changes from Settings.
  • Existing installations with a valid saved language continue into the app without being asked to select it again.
  • Flow progress is device-local, independent of account and language preference, and uses stable IDs rather than screen indices. Define coordinator-owned navigation and an explicit first-step exit policy; required language selection cannot be bypassed.
  • Saving blocks duplicate actions; failed saves show a localised retryable error and do not advance. Existing locale preview/persistence tests remain passing, and startup/coordinator behaviour is covered.
  • Update CONTEXT.md and record the flow, step, progress and completion policies in the repository's domain documentation; do not expand unrelated product scope.

Design sources and scope

Use only the Design and Design tokens pages in https://www.figma.com/design/yisgB7iNKYtjNZdogARGIN/Bebin-prvi-meni . Exclude the reference-app page entirely.

Approved scope: any number of code-defined onboarding flows, each with any number of screens. The initial product flows are language selection followed by a skippable app introduction. No remote flow editor, analytics, account requirement, baby profile, baby-age collection or subscription setup is introduced. Preserve existing online-required and screen-capture protection policies.

Blocked by

None - can start immediately

VJ Updated by Vince Jurić 21 days ago Actions #1

  • Status changed from To Do to Done
Actions

Also available in: PDF Atom