Getting Started
Go to sesh-44g.pages.dev in Safari, tap the Share button, then tap Add to Home Screen. Sign in with your email and password.
After any app update, close and reopen SESH from your home screen icon to load the latest version.
Navigation
Log — your current workout session
Exercises (barbell icon) — your exercise library
History — all past sessions and entries
Injuries (clipboard icon) — injury diary and severity tracker
Admin (person icon) — this guide, sign out
The active tab highlights in white.
Logging a Workout
On the Log screen, tap one of the four category buttons — Strength, Cardio, Core, or Physio — to open the exercise picker. Your session timer starts automatically when you add your first exercise.
Search or browse the picker to find your exercise, then tap it to add it to your session. Tap + New Exercise to create a new one on the spot.
Strength / Core / Physio: enter weight (kg) and reps for each set. For exercises set to Each Side, the reps column shows reps/side. Tap Add Set to add more sets.
Cardio: enter speed, incline, resistance, and/or duration as relevant.
Each card shows your PB (personal best — best single set ever) and Prev (best single set from your last session) badges.
Tap Mark Done to save an exercise. Tap Cancel to remove it without saving. When your workout is complete, tap End Session.
Use Adjust (pencil icon on the timer) to add or subtract minutes from the session duration while the session is active.
Personal Bests (PB)
PB is calculated as your best single set ever — the highest weight × reps in one set across all sessions. Displayed as 35kg × 8.
Prev shows the best single set from your most recent completed session for that exercise.
Both badges appear on the log card during a session, and on the exercise edit screen. Tap any PB badge to see a description.
Exercise Library
The Exercises tab shows your full library. Filter by category, equipment type, or muscle group, or use the search bar.
Tap + New to create an exercise. Fill in the name, category, equipment type, muscle group, notes, and side type (Each Side or Both Sides Together).
Equipment options for Strength: Machine, Cable, Free Weight (Dumbbell, Barbell, Kettlebell, or Band), Body.
Exercise Image: tap Search to open the image search (WorkoutX, Free DB, Life Fitness sources), or Upload to use an image from your camera roll.
Exercise Video: tap YouTube to search YouTube for a tutorial (pre-filled with the exercise name). Copy the URL and paste it using Paste URL. Or tap Upload to upload a video from your device. Tap the video thumbnail on any exercise card to play it.
Tap any exercise to view its detail and full history. To archive: open the exercise, tap Archive Exercise. History is preserved.
History
The History tab shows all past sessions. Use the filter tabs:
By Date — all sessions grouped by date. Each date shows the number of exercises (🏋) and session duration. Use the search bar to filter by exercise name.
By Strength / By Cardio / By Core / By Physio — all entries for that category grouped by exercise, newest first.
Tap the pencil ✎ icon to edit a past entry. Tap the bin icon to delete it.
Injury Diary
The Injuries tab lets you log and track injury episodes — useful for identifying patterns and communicating with your doctor or physio.
Tap + Log New Episode to record an episode. Choose an existing injury or define a new one (Name, Type, Body Part, Side).
Episode fields: Severity (1–10 slider), Duration, Type of Pain, Activity During Episode, Activity Within a Day of Episode, Activity Within 2 Days of Episode, and Notes. Select Other in any activity field to type a custom entry. Tap the Meds chip in any activity field to log medication detail alongside that entry.
Viewing episodes: filter by By Injury, By Date, or By Severity. Use the search bar to filter by name, type, body part, pain type, or notes.
Tap Edit on any episode card to update it, or Delete to permanently remove it. Tap the pencil icon on any injury header to edit its details. Tap the bin icon on an injury header to archive it — episodes are always preserved.
Severity Tracker
The Severity Tracker chart at the top of the Injuries screen shows your episode severity by day for the current week. Navigate weeks with the pink arrows.
Bars are stacked: green = Low (1–3), amber = Med (4–6), red = High (7–10).
A blue dot below the day label indicates you had a gym session that day (from your session history). A purple dot indicates a walk was logged against an injury episode that day. Both can appear together.
Medications
The Medications section (within the Injuries tab, accessible via the tab at the top) lets you track your current medications.
Tap + Add Medication to log a medication with name, strength, quantity, unit, frequency, and when taken. Medications can be archived when no longer current.
Tips
Your session is automatically saved as a draft. If you close the app mid-session and reopen it on the same day, your session will still be there.
Sessions auto-pause after 3 hours of inactivity — you'll be prompted to continue or end.
The Prev badge on each log card shows your last session values as a quick reference while logging.
Technical Reference
App Architecture
SESH is a single-file PWA — the entire app lives in one index.html file. Hosted on Cloudflare Pages with Supabase as the backend.
Development
Built with Claude AI (Anthropic). Development happens in the Claude chat interface using the SESH project. Two documents are maintained in project knowledge: SESH_TechnicalReference (architecture and style standards) and SESH_SessionHandoff (current state and pending items). Both are updated at the end of each session.
Database — Supabase
Project: ntcftlpylupzatkxfuqn.supabase.co
Tables: exercises, sessions, session_entries, injuries, injury_episodes, medications
Storage: exercise-images bucket (photos and videos)
Hosting
Cloudflare Pages: sesh-44g.pages.dev
Deploy via: Cloudflare Dashboard → Pages → sesh-44g → Upload assets