Project

General

Profile

Actions

Feature #30

closed
VJ

Epic #20: Client design adaptation

Adapt Guides to the richer List layout

Feature #30: Adapt Guides to the richer List layout

Added by Vince Jurić 25 days ago.

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

0%

Estimated time:

Description

Imported from GitHub issue 272.
Source milestone: Redesign (milestone 3).
Source labels: enhancement, ready-for-agent.
Original state: closed.

What to build

Type: AFK

Deliver the fixed richer Guides List presentation with wrapping editorial rows. Guides has no display-mode switch and no tile/grid alternative in this scope.

Source: registered Guides.

Use only the Design and Design tokens pages of https://www.figma.com/design/yisgB7iNKYtjNZdogARGIN/Bebin-prvi-meni. Exclude the reference-app page from inspection, implementation decisions and verification. Reuse existing theme, typography, pressables, access gating and localisation. Read the required Expo 57 documentation before coding. Coordinate with the related filtering issue without duplicating its toolbar, draft state or count work.

Related filtering work: GitHub 268. Coordinate changes to shared catalogue surfaces; this is not a hard prerequisite.

Acceptance criteria

  • Rows use the designed topic icon/fallback, title, applicable lock badge and dividers; heights adapt to wrapping content rather than clipping to a fixed row height.
  • Display topic labels, excerpts and reading time only where supported by the existing content contract and established derivation rules. Do not invent tags, sample copy, new editorial fields or reading-time formulas to match Figma examples. Document omitted unsupported fields in verification evidence.
  • Preserve documented guide sub-section grouping, ordering and visibility of matching groups. Search/filter results and incremental loading behaviour remain intact.
  • Lock badges reflect the current viewer; selecting an item follows existing detail/authentication/upgrade navigation and preserves context on return.
  • Integrate with the Guides filtering toolbar without duplicating controls or resetting selections during presentation changes.
  • Tests cover wrapping/optional-field behaviour, group visibility, access-aware locks and navigation.
  • Fixed copy is complete in Serbian Latin and English; admin-managed labels use existing localisation fallback rules.
  • Missing images and optional metadata have appropriate existing fallbacks; long titles and larger text remain readable and controls have accessible names/states.
  • Focused behaviour tests pass, along with client tests, lint and typecheck.
  • Verify on the ADB-connected Android device and attach comparison evidence against permitted Figma screens, including locked/unlocked content, both locales, empty results, pagination and navigation return.

Blocked by

None - can start immediately.

Acceptance verification

All 10 criteria verified against 2267544 on codex/issue-272-guides-list, 23 October 2026. This records acceptance verification, not merge or release.

  • Complete acceptance matrix, permitted Figma comparisons and native evidence.
  • Machine-checked actual-screen evidence, including identical row geometry after guest sign-in cancellation, free-viewer upgrade cancellation and normal detail return.
  • The actual Guides screen was traversed through all 43 controlled records across all six canonical groups. Cursor pagination is not applicable: the existing Guides API loads a complete catalogue; virtualised scrolling and matching/group visibility are preserved.
  • Native checks cover both locales, title fallback, locks/unlocked Premium rows, empty results, search-only matching groups, 130% text and a real icon-load failure fallback.
  • Unsupported Figma excerpts, extra tags and reading-time values/formulas are deliberately omitted. Canonical sub-section labels are retained.
  • Controlled public-store inputs/viewer-hook values were used with the real screen/repository/cache/navigation. These are not real guest/free sessions or a Firestore-network pagination test. No account, subscription or staging records were modified; all temporary wiring was removed and normal app settings/data restored.
  • Final client checks: 502 tests / 67 files, lint and typecheck passed. Native evidence verifier, both instrumentation replay checks and whitespace checks passed.

No data to display

Actions

Also available in: PDF Atom