Project

General

Profile

Actions

Feature #37

closed
VJ

Epic #20: Client design adaptation

Add the three-screen app introduction

Feature #37: Add the three-screen app introduction

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 284.
Source milestone: Milestone 3.
Source labels: enhancement, ready-for-agent.
Source state as of 30 October 2026: closed.

What to build

After language confirmation, show a skippable app-introduction flow containing the three approved Figma slides. Deliver the complete journey through Home with persisted progress and shared slide presentation. This is an AFK slice.

Design nodes: Onboarding 1 (71:2831), Onboarding 2 (71:2852), Onboarding 3 (71:2872). Topics: Meal Plans, Foods introduction/serving guidance, and tried-food tracking with notes.

Acceptance criteria

  • Fresh installations run language selection, then the introduction, then Home, without authentication or a paywall.
  • A reusable slide layout renders the three screens with source SVG artwork, pale circular illustration backgrounds, centred headings/body copy, top Skip, progress indicators and bottom action. Use existing tokens/typography; treat 390 x 844 as a reference rather than fixed device dimensions.
  • Next advances one step; Back returns within the introduction. At its first step, Back stays in the introduction rather than exiting to Home. Skip completes this flow from any slide; Finish on the last slide completes it and enters the next eligible flow or Home.
  • Stable step IDs and the coordinator drive navigation; screen count is not hardcoded to three. Dedicated language selection and shared slide screens coexist.
  • Serbian Latin and English copy are complete, immediately follow the chosen locale, and use natural whole paragraphs rather than Figma's manual line breaks. Follow Serbian ekavian conventions and established product terminology.
  • Copy describes currently available features accurately, including any account/access limitations for tracking and notes; do not promise automatic age personalisation or introduce those features to satisfy obsolete copy.
  • Persist successful transitions, Skip and Finish before advancing. Resume the last successfully saved introduction step after relaunch; failed writes leave the current step retryable and prevent duplicate transitions.
  • Existing installations with a valid saved language and no new onboarding progress bypass the initial introduction. Fresh installations interrupted after choosing a language remain eligible for it: persist an explicit distinction rather than inferring upgrade status from the saved locale alone.
  • On Android, layout respects both safe areas, supports smaller portrait screens and larger text without clipping, and exposes meaningful screen/step announcements and action labels. Decorative artwork/dots do not produce repetitive screen-reader output in the tested TalkBack paths. Native iOS verification of these requirements is tracked separately in GitHub 287.
  • Tests cover both locales, fresh and existing users, Next/Back, Skip, Finish, interrupted sessions, save failures and duplicate taps. Update domain documentation with the shipped initial flows and upgrade policy.

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

Acceptance verification — 28 October 2026

Criteria 1–8 and 10 passed implementation review, automated coverage (542 client tests plus six release checks; typecheck and lint passed), and applicable Android device checks on the Motorola edge 50 pro. Detailed evidence is recorded in docs/onboarding-introduction-acceptance-284.md in the current workspace implementation.

Criterion 9 passed for the verified Android scope. The keyboard-focus defect is fixed in 97fcac3: keyboard Next/Back and touch-style navigation focus and announce the new step in both languages. Verification passed on the Motorola edge 50 pro with TalkBack enabled and disabled. The updated suite passed 545 client tests plus six release checks; typecheck and lint passed. Evidence: docs/onboarding-introduction-acceptance-284.md.

At the user's request, the remaining iOS safe-area, smaller-screen, larger-text, VoiceOver and keyboard checks have been transferred explicitly to GitHub 287 and remain unchecked there. This checklist does not claim native iOS verification or a complete physical TalkBack gesture audit.

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

  • Description updated (diff)
  • Status changed from To Do to Done
Actions

Also available in: PDF Atom