From 3de4ed2a1b81f01a8d6767e8b56748515d243a24 Mon Sep 17 00:00:00 2001 From: Cedric Hornberger Date: Wed, 28 Oct 2026 22:55:34 +0100 Subject: [PATCH] Record Player flow, Streak and identity decisions Co-Authored-By: Claude Opus 5.5 --- GLOSSARY.md | 20 +++++++++++++++---- .../0004-player-flow-streak-and-identity.md | 13 ++++++++++++ future_ideas.md | 3 ++- 3 files changed, 31 insertions(+), 5 deletions(-) create mode 100644 docs/adr/0004-player-flow-streak-and-identity.md diff --git a/GLOSSARY.md b/GLOSSARY.md index 7901f97..83aff9c 100644 --- a/GLOSSARY.md +++ b/GLOSSARY.md @@ -45,9 +45,19 @@ One Exercise inside a Plan, with Mode-specific parameters: _Avoid_: Item, entry **Superset**: -Two or more Workout Steps grouped so they are performed alternately, one set of each in turn. +Two or more adjacent Workout Steps grouped so they are performed alternately (A1 → B1 → A2 → B2 …). +It has one set count; each Step keeps its own reps or duration and weight. Rest between its Exercises +within a round is optional; the Rest Screen always follows the end of a round. _Avoid_: Circuit, combo +**Rest Screen**: +In Workout Mode, the screen after "Set done": a count-up timer ("Resting 1:12") and a "Start next set" +button. Nothing counts down. Timed sets start only when the user taps Start. + +**Transition**: +In Stretching Mode, a short card between rounds, sides ("Switch sides") and Exercises, after which the +next hold starts automatically. Length set per Plan, 5 s by default. + ## Sessions **Session**: @@ -58,7 +68,9 @@ _Avoid_: Workout, run **Player**: The guided, one-Exercise-at-a-time screen used to perform a Session. It shows a large countdown ring, pulses the Mode's accent colour in the last three seconds, shows full-screen "next" cards, advances -automatically when a timer ends, keeps the screen awake, and plays a gentle sound. No vibration. +automatically when a timer ends and keeps the screen awake. A single soft chime (singing bowl in +Stretching, muted "tok" in Workout) plays only when a timer ends or something new starts; it mixes +with the user's music and can be muted. No ticking, no vibration. **Set Log**: The reps and weight actually done for one Workout set, prefilled from the Step's targets and confirmed @@ -68,5 +80,5 @@ with "Set done". The per-Mode list of Sessions with date, Plan, duration and Set Logs. **Streak**: -A single, Duolingo-style daily streak shared by both Modes: consecutive days with at least one complete -Session in either Mode. Incomplete Sessions do not count. +A single, subtle, Duolingo-style daily streak shared by both Modes: consecutive days with at least one +complete Session in either Mode, however short. Incomplete Sessions do not count. diff --git a/docs/adr/0004-player-flow-streak-and-identity.md b/docs/adr/0004-player-flow-streak-and-identity.md new file mode 100644 index 0000000..cd1f4fb --- /dev/null +++ b/docs/adr/0004-player-flow-streak-and-identity.md @@ -0,0 +1,13 @@ +# ADR 0004 — Player flow, Streak and app identity + +Status: Accepted (2026-10-28) + +1. **Sound**: One soft chime per Mode, only on timer end / next item. Mixes with other audio. Mute toggle. +2. **Workout rest**: No countdown and no rest settings. A count-up Rest Screen with "Start next set". +3. **Stretching flow**: Automatic, with Transitions (per-Plan length, default 5 s). +4. **Supersets**: Workout only; one set count; round-robin; optional rest between Exercises in a round. +5. **Streak**: One daily Streak across both Modes, kept subtle; any complete Session counts, no minimum. + Local notifications are in scope for v1 (to help keep the Streak). +6. **Theme**: Fixed look per Mode, no light/dark setting for now. +7. **Fonts**: Nunito (Stretching), Barlow Condensed (Workout). +8. **App ID**: `de.zendric.zenxercise`. diff --git a/future_ideas.md b/future_ideas.md index 664c170..c97366c 100644 --- a/future_ideas.md +++ b/future_ideas.md @@ -5,11 +5,12 @@ Things deliberately left out of v1. - Real exercise animations or video (v1 uses the start/end Flip Animation) - iOS build (and web/desktop) - Accounts and cloud sync / backup -- Scheduling Plans on weekdays, with reminder notifications +- Scheduling Plans on weekdays - Built-in starter Plans - Custom user-created Exercises - Progress charts and personal records from Set Logs - lb units (v1 is kg only) - Vibration cues and voice guidance in the Player - Translations (v1 is English only) +- Light/dark setting per Mode (v1 has a fixed look per Mode) - Mixed Plans that combine Stretching and Workout (e.g. warm-up, workout, cool-down)