Documentation Index

Fetch the complete documentation index at: https://docs.ironcoaching.app/docs/llms.txt

Use this file to discover all available pages before exploring further.

​

Macrocycle Overview

The Macrocycle Overview is a one-page summary of an athlete’s recent training blocks, designed to be screenshot-able for client comms and socials. Reach it from the link beside View Analytics in the client header, or directly at /dashboard/macrocycle/{athleteId}. Available on Pro and Expert plans.

​

What’s on the page

1. Hero row — Best top set per featured lift, with ↑ Xkg vs Start of Macrocycle deltas in green / red / gray.
2. Per-lift section for each featured lift, containing:
   • The 1RM strip (Actual / Estimated / Projected — same component as the 1RM tab)
   • A weekly tonnage bar chart with x-axis labels in the form Block 1 - Week 1, Block 1 - Week 2, …, Block N - Week M
3. Save as image button in the top right that exports the full page as a dark-themed PNG.

​

How blocks are derived

The page does not introduce a new periodization schema. A “block” in this view is a single program_assignments row for the athlete. The chain of assignments — oldest first by starts_at (or assigned_at if no start date) — becomes Block 1, Block 2, …, Block N. Weekly tonnage groups every completed set in the athlete’s session log into the (block, week-since-block-start) bucket the session falls into. Sessions outside any block’s date window are dropped.

​

Featured lifts

By default the page picks the athlete’s top 4 lifts by total completed volume — usually the main movements of the program. To change the selection:

1. Click the Edit pencil beside the block summary in the page header.
2. Check / uncheck lifts in the modal. The cap is 4 lifts total. The list only shows exercises the athlete has actually completed at least one set for.
3. Save. The page updates immediately.

The selection persists per athlete in the coach’s browser. To revert to the auto-pick, uncheck everything and save — the page falls back to the top-4-by-volume default.

​

Best top set + delta

For each featured lift, the hero card shows the heaviest completed set across the athlete’s whole history (filtered to the lift). The delta compares that to the heaviest set inside the first block in the chain — so the delta is “from the start of the macrocycle to now”, not just the current block. If the athlete has only one block on record, no delta is shown.

​

Volume change between blocks

For each featured lift, a Volume change card shows the percent change in total volume from the previous block to the current one. Click the card to expand and see where the change came from:

• More sets — share of the change attributable to the athlete completing more (or fewer) sets
• More reps per set — share from longer (or shorter) sets
• Heavier weight per rep — share from heavier (or lighter) loading

The three components sum exactly to the headline percentage. (Volume = sets × avg reps × avg weight per rep, so the multiplicative decomposition uses logarithmic attribution to avoid the cross-term that drops out of a naive sum.) The card only appears if the athlete has at least two blocks of completed sessions for that lift.

​

Weekly tonnage chart

The bar chart is a Recharts BarChart with cyan bars on the dark theme. X-axis labels are angled at -30° so longer block-week labels stay readable on narrow viewports. Tonnage is computed as sum(weight × reps) over completed sets only — incomplete sets and skipped sessions don’t count.

​

Save as image

The Save as image button captures the entire page (header + hero row + every per-lift section) as a 2x-pixel-density PNG with the navy background preserved. File name format: macrocycle-YYYY-MM-DD.png. Use it for athlete check-ins, weekly social posts, or to share progress externally.

​

Plan availability