Skip to main content

​
The Setup

What it is. The Setup is the object holding an athlete’s fueling dials together: their carriage and fill, their gluc:fruc ratio, and their eco-mode position. It is the one place to read or change how an athlete fuels. When to open it. Any time you onboard, review, or troubleshoot an athlete’s fueling. What changes for the athlete. Their bottle and consumption plan updates and syncs to their app immediately. The Setup lives on the same record the app watches in real time, so there is no separate publish step. The question it answers. “Where do I actually go to change any of this?”

​
Adjusting a Setup

Open an athlete from your roster, then Adjust Setup. A panel opens alongside the athlete’s context.
  1. You see ground truth first. The panel opens read-only on the athlete’s current dials, with an edit affordance, so you never make a blind change.
  2. You edit the dials. Carriage slots for the chosen activity type, the gluc:fruc ratio, and the eco-mode control.
  3. You see the impact in a sentence. As you change a dial, Saturday recomputes and shows one line naming the athlete and their resulting carbohydrate, sodium and fluid per hour under the Setup you are contemplating. A sentence, not a graph.
  4. You save. The change reaches the athlete’s app immediately, and a confirming toast offers a short undo window.

​
The trust model

  • The athlete is told. A coach Setup change sends the athlete a notification naming you, linking to a screen showing that their Setup changed.
  • The athlete keeps control. They can open their Setup and change anything you set. You co-pilot; they keep the wheel.
  • You get a brief undo. For about seven seconds after saving, the toast offers Undo, which writes the previous values back. It re-reads first, so an undo cannot clobber a change the athlete made in the meantime.
  • Every edit is recorded. Coach Setup edits are written to the org audit log with before and after values.
Undo does not un-send the notification. The athlete is notified as soon as you save, not after the undo window closes. If you save and then undo, the athlete may already have been pinged, and undoing sends a second notification. When you are unsure of a change, use the impact sentence to check it before saving rather than relying on the undo.

​
Edge cases worth knowing

  • The athlete has no Setup yet. Open them from your roster and pre-fill from defaults, so a less technical athlete arrives to a working plan.
  • The athlete edits at the same time. If the athlete changes their Setup while you are editing, your save is rejected rather than applied. Saturday shows you what they now have and lets you keep yours, take theirs, or merge. It never silently overwrites the athlete’s own change.
  • You lack Setup-edit access. Adjusting a Setup is a separate grant an assistant coach does not hold by default. Without it, your save is refused and you are told to ask your head coach for access. See Permissions.
  • A malformed change is refused whole. If a Setup write arrives in the wrong shape, Saturday rejects the entire write rather than applying part of it, so a bad request can never half-land on the athlete’s record.

​
See also