Skip to content

Micro-tips: triggers, copy, and persistence #342

Description

@maximsan

Part of #336. Decided 5 September 2026 and closed; the build is #517.

Question

The design's second guide piece: event-driven micro-tips. Which exist and with what copy, what fires each, how dismissal is stored, and how they order against the Today tour.

Ruling

  1. All seven ship, copy verbatim from prototype/guide.jsx:91-98. Checked against each destination screen in the app: none of them repeats what the screen already says; each carries a rule the learner cannot read off the screen (the unlock order and the diamonds on Path, the 48-hour window and the stamp, that only lessons grow the tree, the ribbon, how terms join the Dictionary, the 7-day freeze rule, that the Studio's look applies everywhere).
  2. Triggers as designed (prototype/app.jsx:1196-1214): place tips on first visit to Path, the Dictionary and the unlocked Studio; the save tip after the first save; the challenge, tree and freeze tips on the Learn tab, in that order, each following a beat the learner just saw. Never inside a lesson, never under the tour or a gate sheet. Every tip is dismissable and shows once ever.
  3. Pacing as designed: one at a time, seen on show, 12 s between tips on the same screen, a short beat on a screen change, and the tour finishing counts as "just shown".
  4. Persistence follows tourSeen, not the design. The prototype keeps the seen list in a progress-scoped store that Reset progress wipes. The app already ruled that "already introduced" is not progress: tourSeen sits on the device-local settings row, survives Reset and goes with Delete account. The tips' seen list lives beside it under the same rule. Rulings beat the prototype (docs/README precedence).
  5. Build home: Micro-tips: seven one-time cards that explain a feature the first time it matters #517, takeable now; it does not wait for the tour rebuild Rebuild the guide layer: the four-step Today tour, and App Guide in Settings #341.
  6. The word is micro-tip, in CONTEXT.md; "coach card", "tooltip" and "hint" are avoided.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

design-parityCloses a finding in the app-vs-prototype divergence registerwayfinder:grillingWayfinder grilling ticket (HITL)

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions