Feature #36
closedEpic #20: Client design adaptation
Support configurable onboarding flows through language selection
0%
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
- Status changed from To Do to Done