Documentation

Click-by-click walkthroughs of every shipping feature.

Each walkthrough is generated by the project's automated test suite. The screenshots match the latest build because the test fails when the UI drifts.

Featured

The full operator journey, in one click-path.

If you only read one walkthrough, this is the one. End-to-end from launch to awards: add an athlete, build a meet, auto-seed athletes into events, hand out medals. 17 screenshots, four phases, one passing XCUITest behind it.

Recently shipped

Latest walkthroughs.

Sorted newest-first. Each entry's date is the day its walkthrough went live, not necessarily when the feature shipped.

Meet auto-seed workstream

Build a meet's heats from training PRs in one wizard.

The M-series replaces 480 manual lane assignments with a 5-step wizard: roster → events → policy → review → commit. The engine consumes the same PR data the Athlete page reads; results fan out to the iPad as a new meet (or merge into one already running) via the existing offline-aware authoring path.

Role-fluidity workstream

Know who's running the meet without asking.

The R-series surfaces device roles + capabilities so the operator can spot at-a-glance which iPad is hosting, which iPhones are contributing, and which Mac is just looking. R3+ adds operator-driven role assignment; R5+ lets Primary move across devices.

Awards workstream

Generate the awards ledger from a meet's standings.

The W-series adds an automated awards ceremony to the Mac archive: policy editor → ledger → exports → distribution tracking → athlete-page medal history.

Field events workstream

Score jumps, throws, and verticals the same way you time sprints.

Per-athlete mark entry on iPad + Mac; IAAF tie-aware places via countback (for jumps/throws) and fewer-misses (for high jump / pole vault). The same Standings + Awards surfaces consume both track and field results.

Coach Review workstream

Annotate captured video, frame by frame.

The C-series builds out the coach's video-review surface. C1 ships stroke-on-frame annotation with a JSON sidecar that survives reopens; the in-flight C2/C3 work adds voice notes and per-athlete profile attachment.

Coming next

More walkthroughs are on the way.

Every feature in the workstream gets its own walkthrough as it ships. Roughly in this order:

W3.3 · Planned

Cloud-sync push for awards

Push the awards ledger up to the cloud-sync relay so spectator-app users (R5+) can pull awards without operator email. Same sidecar shape, new transport.

C2 · In design

Coach Review — voice notes

Dictate-to-text against the paused frame, ties into the same sidecar as a sibling VoiceNote record. Useful for "look at his foot plant here" without typing.