Athlete Performance

User guide

A longitudinal training, nutrition and recovery record for a small number of athletes — built so that each athlete's data is isolated by the database itself, not by the screens in front of it.

App: athlete-performance.pages.dev  ·  Guide updated 15-Oct-2026

  1. What this is, and what it is not
  2. Getting in, and installing it
  3. The daily loop — Today, Train, Fuel
  4. Filling in a day you missed
  5. Trends
  6. More — body, health, consent
  7. Coach and admin tools
  8. Who can see what
  9. Privacy, photos and consent
  10. Working offline
  11. What is deliberately not there yet

1. What this is, and what it is not

The app records what an athlete does and how they respond: a daily check-in, training sessions and sets, meals and macros, body measurements and composition, blood pressure, supplements, injuries, lab reports and progress photographs. It keeps that history over months so that a change can be read against a baseline rather than against memory.

It is not a medical record and it does not give medical advice. It is a training and recovery log for coaching use. Anything clinical stays where it belongs — with you.

One idea underlies the whole design: an entry made three days late is weaker evidence than one made that morning. The app therefore never hides when something was recorded. Nothing is ever deleted either — a withdrawn record is marked void and stays in the history.

2. Getting in, and installing it

Open athlete-performance.pages.dev. Enter your email and tap Email me a sign-in code. Type the code from the email into the same screen. The email also carries a link that does the same thing, but the code is more reliable on a phone: it works whichever mail app or browser you open the email in. Once signed in, you can set a password under More → Account, which also shows which email you are signed in with; after that, sign in under Use a password without waiting for an email. If you have forgotten it, or prefer to set one before signing in, enter your email and tap Forgot it, or never set one?, then type the code from that email and your new password. Where Continue with Google or Continue with Apple is shown, use the same email address you were invited with. With Apple, choose Share My Email, not Hide My Email: a hidden address matches no invitation, so you would reach an empty account. There is no app-store download: the page is the app. On the sign-in screen, New here? Getting the app on your phone shows the steps below. The code has 8 digits; if it does not arrive, check Spam, then tap Send a new code.

Your first visit

An account starts with no athlete. The welcome screen shows Signed in as <your email> — if that is the wrong address, Sign out and use the right one. Each address is a separate account; the app cannot look one up for you, so if you have forgotten which you used, search your inbox for the sign-in email.

  1. Privacy notice. Why data is collected, what, who can see it and how to withdraw — shown before any field.
  2. Ask to join as an athlete. Name and date of birth (the two required fields, marked *), and optionally sex, height, sport, city, region and country (never a street address or GPS); the home time zone is set from the phone. Review your details shows it all back with Edit. An unusual age or height is queried, never refused.
  3. Pending. A sent request cannot be edited. To correct it, Withdraw and correct: the form comes back filled in, and the withdrawn request stays on record as withdrawn. Check request status looks again, and the install steps are shown on this screen while you wait.
  4. Approval by a coach or administrator, who confirms your date of birth.
  5. Set-up on Today, one step at a time until done: coaching consent → your main goal → starting weight → your first check-in. Only consent is required: nothing at all can be recorded until it is given (under 18: by a parent or guardian). The other three are marked Optional and have Not now, which is remembered on that phone only.

Put it on the home screen

Installed, it opens full-screen like a native app and works without a network connection (see Working offline). It turns with the phone, so it can be used on its side. On Android, a long press on its icon offers shortcuts straight to Today, Train or Fuel.

Light or dark

It follows your phone's setting. More → Appearance overrides that if you want one or the other — light exists because the dark ground is genuinely hard to read outdoors in bright sun.

Under the same card, Colours offers Rose & Navy (navy with a soft rose, in either light or dark; the default) or Lime & Black. It changes only how the app looks on this device; nothing you have recorded changes.

3. The daily loop — Today, Train, Fuel

Five tabs sit along the bottom. Three of them are the everyday ones.

Today — the daily check-in

Today opens on your Summary, laid out like a phone's health app: a card each for Training, Nutrition, Weight, Sleep, Resting heart rate and Check-in, with the latest value, its date, and a small chart of the last 7 (or 30) days. A day you did not log is a gap in the chart, never a zero; a food total missing a value shows as "≥" or "unknown"; check-in answers are never averaged, only shown as days done. Tap a card to open its detail. Edit chooses which cards show and their order (kept on that phone). Highlights below give plain counts with their basis, such as sessions this week and the week before. Nothing is scored.

Everything that asks for data sits under Log for today, below the summary, and the round + button opens the same four entries from anywhere on the page. During set-up the first check-in waits for Start check-in, and Not now puts it off.

A provisional check-in: four questions, asked one at a time, each answered on a 1–7 number row, where 1 is always the most favourable. The words for the number you tap are shown above the row, and the next question follows on its own; Back and Skip are always there. A last step offers the optional context and a review of your answers before you save. Once saved, the card shrinks to a short summary with Edit.

Under the greeting, four marks show what is logged for the selected day — Check-in, Weight, Meals, Workout — as done or not yet. They are a list, not a score: nothing is "missed". Entries saved on the phone but not yet sent are counted in a small note until they sync. On a Monday, a Last week card gives the previous week in counts (check-ins, sessions, days with meals), each out of 7.

Question1 means7 means
Sleep qualityExcellentExtremely poor
FatigueNoneExtreme
StressNone / very lowExtreme
Muscle sorenessNoneExtreme

Provisional means exactly that: the wording is a working draft awaiting review, it is not a validated questionnaire, and the four answers are never added up or turned into a score. Weight, sleep hours and resting heart rate are on a separate, optional Measurements card; the check-in is complete without them.

Both cards write the same one entry per day, so adding a weight in the morning and the check-in at night gives one day, not two. Earlier check-ins used a 1–10 scale (with Recovery, and sleep quality the other way up). Those are kept exactly as they were and shown separately. If a day already holds an earlier-scale check-in, a new check-in for that day replaces those answers; the earlier ones stay in the change history.

After the four numbers you may add what is affecting how you feel — tap any of Training, Competition, Work, Study, Travel, Illness, Family or Other — and a short note for your coach. Both are optional, neither is needed for the check-in to be complete, and no option counts as good or bad.

If nothing has been logged for a week, Today opens with a short "welcome back" card instead of a column of empty ones. Days you did not log stay unlogged; they are never counted as zero.

Train — a workout, set by set

Choose the type of session (Strength, Cardio, Sport practice, Mobility, Rest day, Other) and tap Start empty workout, then add exercises. Search or browse exercises opens a full-screen list of the library and your own exercises: type part of a name or a muscle, or narrow it by equipment or muscle. The small picture beside each exercise shows its equipment (barbell, dumbbell, cable…), not how the movement is done. Repeat starts a new workout with the same exercises as your last one. A new workout needs a connection to be created; once it exists, its sets can be logged offline. If you finish without ticking a single set, the empty workout is discarded rather than left in your log.

Routines are saved lists of exercises with a target number of sets, a rep range and a rest time. Tap Different reps for each set to give each set its own rep target instead (for example 12, 14, 10, 8). Make your own, save a finished workout as one, copy one from the library, or use one your coach has written for you (marked From your coach). Starting a routine opens the workout with its exercises ready, filled in from what you did last time. A routine never prescribes a weight and never increases anything by itself. The library's starter routines are drafts until they have been approved and published.

Below the start card: This week (sessions, days trained so far, sets) and your Recent sessions. A session from the last seven days opens for editing; older ones are shown read-only.

Each exercise is a small table: SET · PREVIOUS · KG · REPS · RIR · ✓. Previous shows what you did for that exercise in your most recent earlier workout, and today's rows start filled in from it, shown grey until you tick them. A set is saved only when you tap ✓ — a row you never tick is not recorded. A ticked set turns green, and an exercise whose sets are all ticked is marked Done. The top of the workout shows how long it has been running, to the second; this is shown only, not saved.

Ticking a set starts a rest timer, shown large above the tab bar with −15 s, +15 s and Skip. Only one rest runs at a time: ticking a set of another exercise ends the previous rest and starts that exercise's. Each exercise's rest length is set on its card (− and +). The timer keeps the screen on while it runs where the phone allows it. If the phone locks, the timer still keeps the right time, but a web app cannot sound an alert on a locked phone. RIR is reps in reserve: how many more you could have done.

When you tick a set, the next sets of that exercise that are still blank are filled in from it, as a proposal: change them or tick them. What you did last time and a routine's target reps are kept where they exist. + Add set starts from the same set of your last workout when there is one, and otherwise from your last ticked set.

+ Note on an exercise keeps a short note for that exercise in this workout (seat height, belt on, a twinge on the last set). Next time you do the exercise, the card shows last time's note, and Use last time's note copies it in; it is saved only when you tap Save note. A note can be edited or cleared; a workout with a saved note is kept.

Plates (on barbell exercises) works out the plates for each side of the bar for the total weight you type: choose your bar and tap the plates you have. When a weight cannot be made with them it says so and gives the nearest weights that can. It never suggests a weight. Your bar and plates are remembered on this phone.

Session details hold the session's minutes and, from a watch or chest strap, its average and maximum heart rate. For cardio, sport practice and mobility they are on screen from the start; for strength they are folded away. Use the time so far offers today's elapsed minutes, saved only when you tap Save details. A session with no sets is kept once its details are saved, and a rest day is kept as a rest day. Blank stays unknown.

Ticked a set by mistake? Tap its ✓ again: the set is removed, with a few seconds to Undo. A removed set is marked as removed in the record, never erased.

Finish shows the sets and volume, and for each exercise how your heaviest set compares with your earlier sessions of it ("Heaviest yet", "Most reps yet at 60 kg", or your best so far, with the date and how many sessions it was compared with). This is worked out from your log each time; nothing is stored or scored. Volume counts only sets with both a weight and reps, and says how many were left out.

Fuel — logging food

One Log food card: choose the meal (Breakfast, Lunch, Dinner, Snack, Pre- or Post-workout), then search, pick from your recent foods, or add one manually. The first food starts that meal; later ones join it. + Add food on a meal card adds to that exact meal.

Time eaten. A new meal records the time you ate it. For today it starts at the current time; change it if you ate earlier. For an earlier day it starts blank, and blank is kept as time not recorded: the app never guesses a time. Meals are listed in the order eaten, those without a time last. Change or Add time on a meal card corrects it. Breakfast, lunch and dinner are one of each a day; snacks can be several: tapping Snack starts a new one, and + Add food on a snack's card adds to that snack.

Foods come from a reference library (USDA, product labels) and your own saved foods. Where a verified natural serving exists — 1 large egg white, 1 large egg — you enter how many, with the grams shown underneath. There are no guessed conversions between grams and millilitres. A food marked Incomplete is missing energy, protein, carbohydrate or fat; a day that includes it shows its totals as "at least" (≥) figures, because a missing value is unknown, not zero. Each logged line keeps the numbers it was saved with, even if the library entry is later corrected.

+ My measure (under the unit, once a food is chosen) lets you log in your own katori, ladle, glass or bowl. Fill it the way you usually do, weigh it once, and give it a name: "my katori" = 160 g of that dal. It then appears in that food's units, and the line is saved as, for example, 1.5 × my katori (160 g), worked out from 240 g. A measure belongs to one food, because a katori of dal and a katori of rice weigh differently. Removing a measure does not change lines already logged with it.

Other ways in:

To remove a food logged by mistake, tap the ✕ on its line; you have a few seconds to Undo. As everywhere in the app, it is marked as removed, never erased.

Speaking instead of typing: the microphone key on the phone's own keyboard works in every field. The app itself never listens.

If your coach has set targets, the totals card shows your day against them (for example ≥ 96 of 120 g protein). They are information for you, not a mark.

4. Filling in a day you missed

Today, Train and Fuel each carry a strip of the last seven days across the top. Tap a day to enter against it. Future dates are not offered.

Anything entered after the fact is permanently labelled "Recorded N days later" wherever it appears. That label is not a nag — it is the only thing separating a measurement from a recollection, and it is worth trusting the two differently.

The last 7, 30, 90 or 180 days — chosen at the top of the screen, 30 by default, and remembered on that device. Beyond 7 days each card also gives the average over the whole period, with how many of its days were logged. Each card shows the most recent value and a sparkline: body weight, sleep, the four check-in questions on the 1–7 scale, and training volume (number of sessions and total minutes).

Answers on the earlier 1–10 scale appear under their own heading. The two scales run in different directions, so they are never averaged together or joined by one line.

A line needs at least two points; until then the card says so rather than drawing something misleading. The highest and lowest values on a chart are written beside it.

Compare with the previous period adds the period before as a dashed line on the same scale, with its own average and its own count of logged days. Exercise progress shows, for an exercise you choose, the heaviest set on each day it was done and your three best actual sets with their dates — never an estimated maximum. A grid shows the last seven days of check-in answers; a blank is a day not logged.

6. More — body, health, consent, your data

More has two groups: My athlete (body, health, consent, your data, the guide, your account and appearance) for everyone, and Coaching & management (access requests, coach review, administration) for coaches, enrolment approvers and administrators only.

Body & composition

Health

Summary to print

A chosen period (7, 28 or 90 days) on one page: each measure with how many days it was recorded on, and a day-by-day table. Check-in answers are shown day by day with their words (for example 3 · Good) and are not averaged, because the check-in is a provisional monitoring question rather than a validated measurement. Blank means not recorded, never zero, and entries recorded days later say so. Print it, or choose Save as PDF in the print dialog. It contains health information; handle the printout accordingly.

Consent & privacy

What the athlete has agreed to, in the exact wording they were shown, and the means to withdraw it. Covered in section 9.

Your data & rights

7. Coach and admin tools

Athletes today — coaches and admins

Every athlete you can see, in alphabetical order, with plain facts about the last 7 days: check-ins as "x of 7 days" (and whether today's is done), sessions and their minutes (rest days are not counted; when some sessions carry no minutes the total says "≥" and how many did), the latest day with any entry, the last weight, open injuries, and a review whose next date has come. New entries since you last looked marks athletes who recorded something since you last opened the list on this device. If you hold squads, Show narrows the list to one. Nothing is scored, ranked or coloured: a day with nothing recorded is shown as not recorded. Targets sets energy (a range), protein per day and sessions per week for an athlete; a change starts from a date and the earlier targets are kept in the history. An athlete cannot set their own targets. A coach can also write routines for an athlete from their Train screen.

Coach review — coaches and admins

A structured periodic review rather than a free-text note: a summary, a next review date, and any number of observations, each with a domain (e.g. SLEEP), a priority from 1 to 5, an observation and an optional action. Past reviews are listed beneath.

Access requests — enrolment approvers and admins

Deciding requests is a separate permission (Can approve enrolments), not part of being a coach. Each pending request shows the person's email, sport, sex, timezone, height and location. Check the date of birth with them before approving: the athlete is created with the date you confirm. Approving makes them the owner, and makes you their coach if you are a coach or administrator. An enrolment approver who is neither gains no access to the athlete's data.

If the person already has an athlete, approval is refused with that explanation — this is what stops a duplicate record from a corrected or repeated request. Only if they genuinely need a second record, tap Create a second athlete anyway. A request the person has withdrawn cannot be approved.

Administration — admins (enrolment approvers see Invite only)

Two-step sign-in first. An administrator's powers work only after signing in with a second step: the 6-digit code from an authenticator app (Google Authenticator, Microsoft Authenticator, 1Password, Authy). Set it up under More → Two-step sign-in. Until you enter the code in a session, the app treats you as an ordinary account.

What administration deliberately cannot do:

The home screen also shows when the nightly backup last ran.

Home timezone is not cosmetic. It is the athlete's base, not where they are competing. Entries are dated in whatever zone the phone is in at the time, so a 22:00 dinner in Berlin stays on the Berlin day; the home zone is the baseline everything else is read against.

If an athlete is under 18, guardian consent is required under the DPDP Act before any data is collected. The app says so when you create the record; it does not, and cannot, obtain that consent for you.

8. Who can see what

Two separate things decide this, and they are deliberately not the same thing.

Role — what kind of actor you are

RoleCan do
ATHLETERecord and read their own data.
COACHThe above, plus record coach reviews and sign off interpretations.
ADMINThe above, plus administration, and reach every athlete. Only after two-step sign-in in that session.

Enrolment is a permission any account can be given: invite people and decide access requests, without seeing any athlete's data.

Access level — whose data you may touch

LevelMeans
OWNERThe athlete themselves.
COACHFull read and write on that athlete. Can be granted per athlete, or for a whole squad.
READ_ONLYRead, no changes.

An athlete is OWNER of their own record — which must never make them the clinical reviewer of an interpretation written about them. Keeping the two concepts apart is what prevents that.

The isolation is enforced by the database, not the screens. Every table carries a row-level security policy, so a request for data you have no grant on returns nothing at all — regardless of what the app asks for. The failure mode is empty, never everything. It is covered by an automated suite of 435 isolation tests that must pass before any change ships.

9. Privacy, photos and consent

This is health data about an identifiable person, and the DPDP Act 2023 is treated as binding on it.

10. Working offline

Gyms have poor signal. If you are offline the app still opens and still accepts entries: writes are queued on the device and sent when the network returns.

A retry reuses the same identifier as the original attempt, so a flaky connection cannot produce two copies of a session. You can save, walk out, and let it sort itself out. Changes to an existing entry (updating a check-in, adding a weight to a day) are queued the same way. While queued, the app says saved on this phone, not sent yet; it never says sent until the server has it.

If the server refuses a queued entry — most often because coaching consent is no longer in force — the entry is kept on the phone and Today lists it, with the reason, until you choose Try again or Discard. It is never shown as waiting, and never dropped without you deciding.

On an installed app, the app asks the phone to protect its storage so waiting entries are not cleared when space runs low; More → Reminders & install says whether the phone agreed. An access request, consent and your goal need a connection and are not queued.

11. What is deliberately not there yet

Stated plainly so nothing is assumed to exist:

Open the app