Open-source gym & body-weight tracker, now in the App Store (iPhone + Apple Watch) and as an Android APK. Plan routines, log workouts, see which muscles are trained, import from Strong/Hevy/FitNotes. Self-host it or use it on the phone alone.
JavaScript apple-watchbodyweightdockerfitnessfitness-trackergymhealthiosmcpnodejspasskeysprogressive-web-applicationspwareactself-hostedself-hostingvitewebauthnweightliftingworkout-tracker
Merge origin/main into release-1.4.3 (App Store launch docs, website ?v=28)
Duarte Santos2c9a3f1ba9e7
diff --cc CHANGELOG.mdindex 4a946e169,c0cf16eb7..0de56f618--- a/CHANGELOG.md+++ b/CHANGELOG.md@@@ -1,306 -1,6 +1,306 @@@# Changelog+Newest first. Each release is a `## vX.Y.Z (YYYY-MM-DD)` section, and the release notes on+GitHub and GitLab are that section, word for word. New work goes under `## Unreleased` until the+tag. Write it for the people using the app: what changed for them, short, no em dashes.++## Unreleased++**Gym reminder** (#614, phone app). Walk into your gym and openGym nudges you to hit Start. Add+your gyms in Settings → Reminders → Gym reminder: "I'm at the gym right now" or a pin on an+OpenStreetMap map, each with its own radius and text. Once a day at most, never after you trained,+never mid-workout, optionally only between certain hours. Off by default, and your gyms stay on+the phone (not on your server, not in backups). Android uses the system's own proximity alerts,+so no Google services are needed. Android can be slow to notice you arrived (up to half an hour),+so near a gym the phone can take a short GPS look and nudge you at the door; that needs openGym's+battery use on Unrestricted (Settings shows it as "Quick arrival check"). And if you logged a+workout on your laptop that your phone hasn't synced yet, the phone asks your server first (3+seconds at most) instead of nagging you anyway.++**See what a session hits before you start it.** Every routine on the Plan page (the week, the+rotation and the routine list) and today's session on Home now carry a tiny body, front and back,+with the muscles it works lit up. No more opening Leg Day to remember it is, in fact, legs.+And it keeps going once you start: the exercise chips at the top of a workout end in the same+tiny body, faint where the session is headed and lit up where you've already ticked sets, in every+layout and without moving a single set row (#670). Tap it for the big map and done/planned sets+per muscle. Settings → Workout → Fine-tuning turns it off.++- **Machine taken? One tap to your backup** (#649). A routine exercise with planned backups+ now lists each one in its ⋯ menu during a workout. Tap it and the backup takes over with the+ slot's own sets, reps, rest and warm-ups, and the exercise it replaced becomes its backup, so+ going back when the bench frees up is one tap too. Your routine stays exactly as it was.+- **Machines with odd weight steps** (#688). A machine or cable exercise now has a Weight stack+ under Plate loading: type in the weights its pin really picks (5, 11.3, 18.1, the LifeFitness+ special) or fill an even stack and fix the odd ones. Progression, deloads, warm-ups, drops and+ the + and − buttons then land only on those, and at the top of the stack it holds and says so.+- **Lifts against your body weight** (#729, thanks @radu781). Exercise progress in Stats and an+ exercise's History have a Bodyweight view: your estimated 1RM or heaviest set as a % of what+ you weighed then, so the line only climbs when you got stronger for your size. Pull-ups and+ dips count you plus the belt, assisted machines you minus the help.+- **Log a workout by telling your AI about it** (#739, thanks @matthewjablack). The optional MCP+ server gets `log_workout`: "curls, 12 kg, 12/12/10" lands in your history on every device,+ saved through your own server like a paired phone. It asks back when a name could mean two+ exercises, never logs the same thing twice, and takes 20 workouts an hour at most.+- **The AI Coach is one tap away for admins** (#683, thanks TheBlackSide243). On a server that+ offers the Coach, admins now find an AI Coach row in Settings, right next to Look, that opens+ the admin dashboard straight at the Coach card.+- **Call an exercise what you call it** (#624, thanks Space-Hermes). "Add another name" under an+ exercise's tags (or in your own exercise's form) gives it other names, like OHP for the overhead+ press, and the search finds it by those too. They sync between your devices and travel with+ your own exercises in shared plans.+- **Discard means discard, on the Apple Watch too** (#776). Discarding a workout on the phone+ while the watch follows it used to save it to Apple Health anyway, calories and all. Now the+ watch drops it and Apple Health never hears about it.+- **The Coach remembers both devices** (#779, thanks @Klein225). With the Coach open on two+ devices, the one that synced last could wipe the other's chat, log and Undo history. Now they+ merge message by message, and a plan you already applied on your phone no longer gets a+ "nothing I would change" reply on your laptop.+- **A Coach plan goes into your rotation** (#778, thanks @Klein225). Training on a rotation, a+ plan from the Coach used to land in the weekly schedule, which a rotation ignores, so Home kept+ showing your old sessions. Now the rotation switches to the Coach's routines and starts over+ with the first one, and Undo puts your old rotation back.+- **Imported weigh-ins stay put.** Weigh-ins you import (an Apple Health export, a Google Health+ or Health Connect CSV, Strong, Hevy) are no longer written back to Apple Health or Health+ Connect, where they landed a second time. Only weigh-ins you enter in openGym go out.+- **Heart rate for sets you tick on the phone.** With the Apple Watch running the session, a set+ ticked on the phone now gets its heart rate from the watch too, not just the ones ticked on+ the wrist.+- **A run is a run in Apple Health** (#799, thanks @svillar). A workout that was only running+ used to land in Apple Health as strength training, from the watch every time. Now runs, walks,+ rows, rides, jump rope, HIIT, yoga and stretching each get their own type, on the iPhone, the+ Apple Watch and in Health Connect. Lift anything at all and it's strength training, as before.+- **Back means back.** A page's own back button now brings you back where you were scrolled,+ just like the edge swipe, and Body measurements goes back to Stats instead of Home. The titles+ beside those back buttons all sit the same distance from them now (#704, #763, #764, thanks+ @kurktchiev and @lajawi).+- **Android back stops touring your tabs.** Hopping between Home, Plan, Stats and Exercises no+ longer piles up history that Back then replays: on a tab, Back goes straight to "press again+ to exit" (#705, thanks @chang0022).+- **One "Rest's over" on iOS.** The end of a rest could leave two identical banners stacked+ (#728, thanks @2baek2).+- **Discard workout is harder to hit by accident.** It lived at the bottom of the workout's ⋯+ menu as a red trash, exactly where an exercise's ⋯ keeps Remove exercise. Now it's only in the+ Finish sheet, next to Finish and save, still with its "are you sure" (#751).+- **Apple Watch keeps up.** The watch could miss the phone right after launch and then hear+ nothing until you reopened the app, a freshly installed watch app could wait for your next change+ before it got your routines, and one odd routine could hide all of them. All fixed. Until the+ phone has sent anything the watch now says "Not synced yet" and what to do about it, and+ Settings → Apple Watch on the phone tells you when it last heard from the watch.+- **Faster on long histories.** Home and Stats do far less work per open (Stats about a third+ less on 800 workouts), the main script a start parses is a quarter smaller, the installed web app stops asking+ the server about every file on each launch, and other languages load their words in one go+ instead of three trips.+- **Muscle balance**: tap a muscle you haven't trained right on the map and its row offers the+ exercises for it, the same way the "Not trained" chips do (#553).+- Stats' Week rows lose a stray line over each done/planned figure, which also sat a little+ low next to its bar.+- **Exercises start the way you do them.** Add a plank, a wall sit or a dead hang and it starts+ as a timed hold (#694, thanks @lodepav). A one-arm row or a single-leg press starts per side+ (#736, thanks @lodepav). Jumping jacks, burpees, star jumps and tuck jumps start as sets × reps+ instead of minutes and speed (#717, thanks @zykll18), and so does jump rope, double unders+ included (#796, thanks @sc962). Only fresh picks: what's already in your routines and history+ stays exactly as you set it up.+- **"No timer" for a single exercise.** Rest for this exercise now has the same three choices as+ the warm-ups: your default, No timer, or a time of its own. Stretches and carries can finally+ skip the countdown while your squats keep theirs. Saved in routines, shared plans and backups.+- **The rest wheel starts where your rest is.** Pick a time opens on the rest that applies right+ now (the exercise's, the warm-ups', or your default) instead of sitting at 0:00 (#735, thanks+ @lodepav).+- **Volume while you lift.** The progress bar at the top of a workout now ends in the session's+ volume, adding up every set you tick, in all four layouts. Handy for deciding whether today was+ enough or you've got one more in you (#774).+- **Count warm-ups in volume**, if you like (#719). A new switch in Settings → Units & language+ adds your done warm-ups to every volume the app shows: the workout, the summary, history,+ Stats, the report and the coach. Off by default, and records ignore warm-ups either way. The+ warm-up line in Exercise settings tells it like it is, whichever way the switch is set.+- **Lifted in total.** Stats has a new tile with everything you've ever lifted, imports included.+ Spoiler: it's a lot.+- **"No automatic progression" remembers what you did** (#217, thanks @iggaM23). With Settings →+ Workout → Fine-tuning → Planned sessions start from → Your last session, an exercise with+ progression off now opens at last time's weight and reps, the way Strong does it, and the card+ says so. "Your plan" (the default) still opens at the routine's own numbers, and deload+ routines keep theirs.+- **"Last time" can mean any workout** (#770). Bench on Monday and Thursday? Settings → Workout →+ Fine-tuning → Last time means → Any workout lets Thursday start from Monday, for the rows, the+ "last time" line and progression alike. The default stays per routine, so a heavy day and a+ light day keep their own numbers.+- **Deleted a weigh-in by mistake? Undo.** Deleting one now shows a toast with Undo, on the log+ sheet and in All weigh-ins, and the weigh-in comes back as if nothing happened (#756).+- **Custom measurements get their own unit** (#699, #718, thanks @zykll18). Muscle ratio in %,+ lean mass in kg or lb, a calf in cm or in, or no unit at all for a visceral fat score. The chart,+ the history and backups keep it, and your old custom fields stay in cm like before. The body+ CSV export says each field's unit in its column, and importing that file now brings the+ measurements back too, not just the weigh-ins.+- **Your weekly rate, with a corridor** (#759). Under the body-weight chart on Home and in Stats:+ the trend through the last three weeks of weigh-ins, in kg or lb and in % of body weight a+ week, so one salty dinner can't fool it. Tap it to set what you aim for (lose, gain or hold,+ in % or in your unit) and the card tells you whether you're on pace, too fast or too slow.+- **The plate hint says plates, not reps** in Chinese and Korean: "20 per side" read as twenty+ reps a side (#689, #698, thanks @xueyang-dev).+- **Increase Contrast and Reduce Transparency are honoured** (#707, #708, thanks @olestrr). With+ Increase Contrast on, colours, secondary text and hairlines get firmer (every button label at+ 4.5:1 or better). With Reduce Transparency on, the tab bar, timer, toast, workout and Coach bars+ go solid instead of frosted.+- **Hej, Sverige!** openGym speaks Swedish now, picked in Settings → Units & language or straight+ from a Swedish phone (#721, thanks @Grizzly163). Exercise names and instructions stay in English+ for now.+- **The Android update actually installs.** Switch to another app while the new APK comes down+ and Android quietly refused to open the installer, so the download finished and nothing+ happened. Now the installer waits until you're back in openGym. Tap the update again after a+ hiccup and it reuses the APK it already has instead of fetching 300 MB twice, and the leftover+ APK is cleaned up once you're on the new version. (The fix lives in the updater itself, so it+ helps from the update after 1.4.3 on: for this one, keep openGym open while it downloads.)+- **Which APK is this?** Settings → About now tells you whether your Android app is the Standard+ (180 px), Plus (240 px) or HD (360 px) one, no guessing from the file size.++**Security.** Follow-ups to v1.4.2's audit.+- **Pairing the phone app asks you to confirm it's you** (passkey, or your password where that+ counts), like adding another device does. A copied browser session can no longer mint a phone+ sign-in that renews itself.+- Deleting your account from a paired phone only skips the passkey for a real phone sign-in, not+ for a browser session sent along as one.+- On iPhone the paired server's sign-in is no longer part of iCloud or computer backups. A+ restored iPhone pairs again.+- The Android updater (direct APK only) installs nothing without its checksum and only its own+ download, and the backup folder is only written to while the app still has your permission.+- Push addresses that hide a private IPv4 address inside an IPv6 one are refused like the plain+ ones.+- Self-hosted images run on this month's patched Node (22.23.4) and nginx (1.30.6), and the+ server and the MCP bridge pick up a fixed `ip-address`. Thanks to MohamedAfrash and lodepav+ (#766, #769).++**Export as a spreadsheet** (#647). Settings → Data & backup → Export as spreadsheet (CSV): your+workouts with one row per set (date, workout, exercise, set, weight, reps, RPE or RIR, warm-ups,+drops, supersets, cardio distance and time) and, as a second file, body weight and measurements.+Pick everything or a stretch of days. Opens in Excel or Sheets, makes your coach happy, and openGym+reads it straight back in without losing a set. The importer also learned GymMane's CSV.++**Keep what you added** (#592). Threw an extra exercise into a routine's workout? The finish+summary lists it under "New in this workout" with one button to add it to the routine, sets, reps+and weight as you did them. Ignore it and the routine stays exactly as it was.++**Support openGym.** Settings → About & updates has the coffee jar: Buy Me a Coffee, Ko-fi and+GitHub Sponsors, and on the iPhone a straight line to writing an App Store review. No pop-ups+asking for anything, promise.++**Settings slides like Settings.** Tap into a settings page and it slides in from the right; go+back and the page before slides back in. The tabs keep their soft fade.++**iPhone first start.** The permission screens have one Continue that leads straight to the+iPhone's own question, so the yes or no is yours to give there, once.++**Fatigue, in numbers.** Tap a muscle on Stats → Fatigue and you get its fatigue in percent on a+little Ready / Recovering / Fatigued bar, plus when it drops back to Recovering and to Ready if+you leave it alone. Handy for deciding whether those legs are really ready (thanks @sg41).++**Fixes**+- **openGym starts again on iPhones with iOS 15.5 to 16.3** (P1). 1.4.2 and the web demo sat on+ the splash forever there, because one tiny link check used regex syntax Safari only learned in+ 16.4. Rewritten, the build now targets Safari 15 like the app does, and a test reads every built+ file for syntax older iPhones can't handle. Should a browser still choke, openGym now says so+ on screen with the error and a Reload button instead of lifting the logo forever. Thanks+ h097327 for the excellent report.+- Deadlift variants that forgot your lower back remember it now: the kettlebell suitcase+ deadlift and the plate deadlift lunge press (#693, #700, thanks @JeromeTDev and @choksi2212).+- Equipment profiles know more about what an exercise needs. An inverted row needs a bar (unless+ it's the under-the-table kind), a dumbbell fly or a pullover needs a bench, and the massage+ ball is no longer filed as a foam roller. Own no dumbbells at all? The Dumbbells sheet now says+ how to keep them out of the library and the Coach's plans. Profiles you already had keep+ showing what they did.+- The knee-to-chest push-up lives with the chest exercises, not in cardio.+- **Rest days in the rotation**, and the same routine more than once (A → B → C → B → D): Add+ offers a rest day and every routine, including the ones already in the loop (#536).+- Your lats show up: the upper back is "Lats & upper back" in Stats, on the body map and in the+ custom exercise muscle picker (#607, thanks @Parth-Vasave).+- Coach questionnaire: the weekdays picked for you follow the number of training days, and days+ you picked yourself stay put (#620, thanks @Jul11us).+- German: the three lever leg curls say Beinbeugen now, not Beinstrecken like the leg extension+ (#631, thanks @AkashBhat14 and @choksi2212).+- Collapse completed exercises: a finished exercise folds up and the ones after it move up with+ it, no more black gap (#642, thanks @dpatrongomez). That goes for the last exercise in the+ list too when you're scrolled all the way down: the page settles instead of keeping a blank+ strip under it.+- Cardio the Coach prescribes on a non-cardio exercise (kettlebell swings for 15 minutes) stays+ 15 minutes instead of turning into sets with no target, in new plans, in review additions and+ in shared plan files (#640, thanks @rudycelekli for spotting the review side).+- A Coach review that adds a routine with an empty slot in it gets a second try instead of+ failing outright (thanks @rudycelekli).+- The MCP server stops showing a profile whose data was deleted, also where the system can't+ watch files (thanks @rudycelekli).+- Coach on Gemini works with a fresh AI Studio key again: the default is Gemini 3.8 Flash (free+ tier included), and a model your key can't use any more is swapped once for one it lists,+ on the server and on a phone with its own key. If nothing fits, the error names the model (#758).+- Coach through OpenRouter (and other hosts that insist on strict JSON schemas) stops failing+ with "additionalProperties must be explicitly set to false": the request is sent once more in+ the strict shape they want (#701, thanks @choksi2212).+- MCP: `sets_planned` counts per-side sets the way `sets_done` does, so a finished unilateral+ session reads 102/102 instead of 102/54 (#691, thanks @davidjorgensen).+- Jumping jacks, burpees and the other cardio moves can be counted in sets x reps (or timed):+ their settings now offer Cardio, Reps and Time, Cardio still the default (#678).+- Add exercise → By muscle has the Favourites chip too, for the muscle you picked (#669).+- A treadmill's incline can be set in its settings in the routine, not only mid-workout. The+ session opens at it unless last time had a grade of its own, and it travels in shared plans.+- Exercise names on the Lock Screen, in the Dynamic Island, on the Apple Watch and in the widgets+ are title-cased like in the app (Focus mode's exercise menu too), instead of whispering+ "barbell bench press".+- Focus mode: the exercise's ⋯ menu has Add set and Add warm-up set, so one more set no longer+ means a trip to the Cards layout.+- A weight change too small to show (say 0.03 kg) reads 0 instead of a lonely "-0".+- Admin → AI Coach: the Remove button for the stored key is red now, like every other button+ that deletes something for good.+- Focus mode stays on the screen with lots of sets or a long exercise name (#655).+- Chart dates under the graph say each day once over a short span, and months get their year+ once a chart covers more than twelve of them (thanks @lodepav).+- Hevy import: 55 of Hevy's built-in exercises (Seated Leg Curl, Plank, Air Bike, Triceps Dip and+ friends) land on the right openGym exercise instead of a cousin or a custom one, and the import+ summary counts an exercise once even when it's in your workouts and your routines (thanks @lodepav).+ A seated leg curl from any app stays a seated leg curl, Side Plank, Squat (Machine) and the cable+ rear delt fly no longer land on a different lift when you import with your Hevy API key, and 12+ more Hevy titles find their exercise, from Lu Raises to the Bayesian curl (#784, #785, #793,+ thanks @cubetes and @theatosam).+- Imports that convert pounds and kilos keep the weight to the hundredth: 45 lb comes in as+ 20.41 kg and reads back as 45, not 44.97. Hevy notes keep their line breaks instead of a+ literal `\n` (thanks @lodepav).+- German step-by-step instructions for 1,213 more exercises, so all the exercises from before+ v1.4 explain themselves in German now (#645, thanks @junkerderprovinz).+- In the Compact and List layouts the exercise chips at the top follow along: the one you tap+ lights up, and so does the one you scroll to (#323, thanks @Space-Hermes).+- **Rest after this set**: tap a set's number and give just that set its own rest for today,+ a long one before the top set or none after a light one. Default, No timer or Pick a time+ (#609, thanks @Space-Hermes).+- A timed per-side hold can drop its 10 second switch-sides pause without losing the set's rest:+ Rest between sides → No timer. And changing an exercise's settings mid-set no longer forgets a+ side you already ticked (#636, thanks @Space-Hermes).+- The install tip in About on a Windows or Linux browser points at Chrome's install icon,+ not at an iPhone's Share menu you don't have.+- The Coach answers questions now. Type "how many sets of dips is that?" in the chat and you get+ an answer in words instead of a whole revised plan, and a suggestion you were asking about is+ still there afterwards (#660, thanks @TheBlackSide243).+- Automatic Coach reviews on a phone with its own API key finally happen. The setting saved and+ then nothing ever ran them, because only a server ran them. Now the phone does it while the app+ is open: right after the workout that completes the count, or the first time you open it after+ your weekly slot. It only speaks up when it has something to suggest.+- A phone app connected to your server now hears about a suggestion the server's automatic+ review left. The server only knew how to say it by web push, which the app doesn't have, so the+ review ran and the phone stayed quiet. Now the app tells you when you next open it.+- Self-hosting docs for the questions Discord asked this week: getting from zero to a working+ AI Coach (it starts with making yourself admin), nginx under `/gym` in both flavours with the+ three mistakes that break it, passkeys without a fingerprint reader or on plain http, the+ iPhone web app, and moving your phone's data onto your own server. All in the FAQ too.+- Coach on a phone with your own key: Advanced lets you set the daily runs (0 for no limit,+ handy with a model on your own network), the output-token ceiling a reasoning model needs+ raised, and how long a message may be. You're the admin there, after all (#527, thanks+ @xueyang-dev).+- **Wrong address, clear answer.** When your api service's ORIGIN isn't the address in your+ browser, the app now says which address the server expects and what to change, instead of a+ bare "cross-origin request refused". The server log names the exact `ORIGIN=` and `RP_ID=`+ to set (thanks tcmac, who lost a morning to this one).+- Self-hosting on a NAS has its own section now: Synology, QNAP, Unraid and TrueNAS, with a+ two-service compose to paste, absolute paths, ports, permissions and HTTPS. The FAQ explains+ password sign-in (`PASSWORD_LOGIN`) and guest mode (`ALLOW_GUEST`), including why a stack+ without its api quietly turns you into a guest.+- ## v1.4.2 (2026-10-18)+ ## v1.4.2 (2026-10-23)openGym comes to the App Store, with an Apple Watch app in tow. Plus everything you asked forsince v1.4.1, five reported security holes closed and a fresh look at the animations.diff --cc README.mdindex 55984fed3,c5d3da0df..367f758c2--- a/README.md+++ b/README.md@@@ -197,18 -188,18 +199,18 @@@ variable. The [self-hosting guide](docs## Phone app-The same codebase builds a standalone app with Capacitor: no account, no server, everything stays-on the phone, with native reminders and a rest countdown in the notification shade.+The same codebase builds the phone apps with Capacitor. Use them on their own (everything stays on+the phone, no account) or connect them to your server and sync.-- **Android:** download the signed APK from the [latest release](https://github.com/DuarteSantos8/openGym/releases/latest)- or the [website](https://opengym.ch): Standard (`openGym-X.Y.Z.apk`, 180 px animations, about- 315 MB), Plus (`openGym-Plus-X.Y.Z.apk`, 240 px, about 424 MB) or HD (`openGym-HD-X.Y.Z.apk`,- 360 px, about 760 MB). Each sits next to its `.sha256`,- checks for updates itself and stays the kind you picked. A Google Play version is on its way.-- **iPhone and Apple Watch:** the [App Store app](https://apps.apple.com/app/id6822275400), in- every App Store country. Or self-host and add the PWA to your home screen from Safari.+| | Get it |+|---|---|- | **iPhone and iPad**, with the **Apple Watch** app | The App Store. Until it is listed there, the [public TestFlight beta](https://testflight.apple.com/join/RKATb61k) |++| **iPhone and iPad**, with the **Apple Watch** app | The [App Store](https://apps.apple.com/app/id6822275400), in every App Store country |+| **Android** | The signed APK from the [latest release](https://github.com/DuarteSantos8/openGym/releases/latest) or [opengym.ch](https://opengym.ch), in three sizes: **Standard** (`openGym-X.Y.Z.apk`, animations at 180 px, about 315 MB), **Plus** (`openGym-Plus-X.Y.Z.apk`, 240 px, about 424 MB) and **HD** (`openGym-HD-X.Y.Z.apk`, 360 px, about 760 MB). It updates itself and stays the kind you picked |+| **Google Play** | Coming: a new developer account has to run a closed test first |-Details and build instructions: [docs/MOBILE.md](docs/MOBILE.md).+Every APK sits next to its `.sha256`. The APK and the Play app share one signing key, so you can+switch between them (or between Standard, Plus and HD) without losing data. Details, building it+yourself and connecting to your server: [docs/MOBILE.md](docs/MOBILE.md).## How it worksdiff --cc docs/MOBILE.mdindex d0383225b,b2324efcf..2d90c1182--- a/docs/MOBILE.md+++ b/docs/MOBILE.md@@@ -1,23 -1,12 +1,23 @@@# The phone app (Android and iOS)-**Just want the app?** Download the APK from the-[latest release](https://github.com/DuarteSantos8/openGym/releases/latest) (`openGym-X.Y.Z.apk`,-or `openGym-Plus-X.Y.Z.apk` / `openGym-HD-X.Y.Z.apk` for sharper animations at a bigger size) and read+**Just want the app?** See [getting the app](#getting-the-app): the App Store (and the public+TestFlight beta) on an iPhone, the APK on Android. Then read[how the phone app works](#how-the-phone-app-works) and-[connecting it to your server](#connecting-the-app-to-your-own-server). On an iPhone, see-[what's possible](#iphone--whats-actually-possible). Everything from [Prerequisites](#prerequisites)-on is for building the app yourself.+[connecting it to your server](#connecting-the-app-to-your-own-server). Everything from+[Prerequisites](#prerequisites) on is for building the app yourself.++## Getting the app++| | Where | Updates |+|---|---|---|- | **iPhone and iPad** | The App Store. Before it is there, or to test the next version early: the [public TestFlight beta](https://testflight.apple.com/join/RKATb61k) | the App Store or TestFlight |++| **iPhone and iPad** | The [App Store](https://apps.apple.com/app/id6822275400). To test the next version early: the [public TestFlight beta](https://testflight.apple.com/join/RKATb61k) | the App Store or TestFlight |+| **Apple Watch** | Comes with the iPhone app | with the iPhone app |+| **Android, APK** | [GitHub release](https://github.com/DuarteSantos8/openGym/releases/latest) or [opengym.ch](https://opengym.ch). From v1.4.2 in three sizes: Standard (animations at 180 px), Plus (240 px) and HD (360 px, the biggest download) | the app itself, each size to its own kind |+| **Android, Google Play** | Coming: the account has to run a closed test first | Google Play, sharper animations as downloads |++The APK and the Google Play app are signed with the same key, so a phone can move from one to+the other, or between Standard, Plus and HD, without losing its data. How the store builds are made and+released is in [APP_STORES.md](APP_STORES.md).## How the phone app works@@@ -451,19 -312,16 +451,19 @@@ app background). Generate all platform```shcd frontend-npx @capacitor/assets generate --iconBackgroundColor '#0c0e12' --splashBackgroundColor '#0c0e12'+npx @capacitor/[email protected] generate --iconBackgroundColor '#0c0e12' --splashBackgroundColor '#0c0e12'```+The generator is not a dependency of the app (it pulls in an old Capacitor CLI and sharp),+so `npx` fetches it for that one run.+(If the generator won't take the SVG directly, export it to `resources/icon.png` at-1024×1024 first — any image tool can do it.)+1024×1024 first; any image tool can do it.)-## Distribution+## Distributing your own buildThe signed APK stays the way to get openGym on Android without a store, and it updates itself.- The App Store app (public TestFlight beta: https://testflight.apple.com/join/RKATb61k) and the+ The [App Store app](https://apps.apple.com/app/id6822275400) and theGoogle Play build come from the same code; how they are built and uploaded is in[APP_STORES.md](APP_STORES.md).@@@ -507,19 -364,32 +507,19 @@@ zipalign -f -p 4 app-sideload-release-uapksigner sign --ks my.keystore --ks-key-alias opengym --out openGym.apk aligned.apk```-### iPhone — what's actually possible+### iPhone: build it yourself- The App Store app is the easy way. If you want your own build, for example of a fork:-> The App Store and Google Play builds, and how a release gets there: [APP_STORES.md](APP_STORES.md).++The [App Store app](https://apps.apple.com/app/id6822275400) is the easy way. If you want your own build, for example of a fork:-The [App Store app](https://apps.apple.com/app/id6822275400) is the easy way. Apple does not allow installing-apps outside the App Store, so there is no `.ipa` download that would simply install. Without the-store, your free options:--- **Self-host + PWA** (recommended): open your instance in Safari → Share → *Add to Home- Screen*. Full-screen app, no expiry, plus sync and passkeys.- **Xcode free signing:** open `ios/` in Xcode with a free Apple ID as the team and run itonto your own iPhone. Apple expires the signature after 7 days; re-run from Xcode to renew.-- **AltStore:** automates that 7-day re-signing over Wi-Fi via a Mac companion app.--There is a `build:ios` job in [`.gitlab-ci.yml`](../.gitlab-ci.yml) for exactly that path: the-same mobile bundle, `xcodebuild archive` without a signing identity, and an *unsigned* `.ipa`-(plus `.sha256`) as job artifact — on a tag also under `opengym-ios/<version>/` in the package-registry — for AltStore/Sideloadly users to sign with their own Apple ID. It needs a Mac: Xcode-does not run on the Linux project runner, and gitlab.com's hosted macOS runners are not on the-free tier. To switch it on, register a Mac as a project runner (shell executor; Xcode, CocoaPods-and Node installed; give it a tag such as `macos`) and set the CI/CD variable `IOS_RUNNER_TAG`-to that tag — the job then appears in every `main` and tag pipeline. Until that variable exists-the job is not part of any pipeline, and it has not run yet, so expect a first round of fixes.-The signed App Store and TestFlight builds don't come from this job: GitHub's `iOS` workflow-archives them unsigned and the release machine finishes, signs and uploads them-([APP_STORES.md](APP_STORES.md)).+- **AltStore / Sideloadly:** automate that 7-day re-signing.+- **Self-host + PWA:** open your instance in Safari → Share → *Add to Home Screen*. Full-screen+ app, no expiry, plus sync and passkeys.++Every pull request that touches the iOS shell is compiled on a Mac by the `iOS` GitHub workflow+(`.github/workflows/ios.yml`), which also starts it in the simulator. Its unsigned IPA has no+web assets; `scripts/ios/finish-ipa.sh` adds them and signs it on the release machine.### Release notes for maintainersdiff --cc website/docs.htmlindex 9902ef4e2,002c197c3..59a23d9dc--- a/website/docs.html+++ b/website/docs.html@@@ -31,7 -31,7 +31,7 @@@<!-- Umami web analytics for opengym.ch (self-hosted, cookieless). --><script defer src="https://stats.duarte-santos.ch/script.js" data-website-id="db36019e-50f4-453c-9c56-d0588aefe233"></script><script type="application/ld+json">- {"@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [{"@type": "Question", "name": "Is openGym really free?", "acceptedAnswer": {"@type": "Answer", "text": "Yes — free as in cost and as in freedom (AGPL-3.0). No pro tier, no locked features, no ads, and the license keeps every fork open source too."}}, {"@type": "Question", "name": "Is openGym in the App Store and on Google Play?", "acceptedAnswer": {"@type": "Answer", "text": "The iPhone app, with the Apple Watch app, is on its way into the App Store, and the public TestFlight beta is the same app until it is listed. Google Play follows once a new developer account has finished its closed test. On Android the signed APK is a direct download in the meantime."}}, {"@type": "Question", "name": "Should I pick the mobile app or self-host?", "acceptedAnswer": {"@type": "Answer", "text": "To simply track your training: the mobile app. For data on your own hardware, synced across devices, with profiles for the people you train with: self-host with Docker. The backup file migrates everything between the two, or pair the app to your server."}}, {"@type": "Question", "name": "What's on the openGym roadmap?", "acceptedAnswer": {"@type": "Answer", "text": "A small, themed release every two weeks: the gym reminder and health data read back from the phone (v1.4.3), then programmes and phases, Google Play with a new progression engine, cardio, better search, password and OIDC accounts, a trainer role, wearables, and database storage after that. The full plan is in ROADMAP.md on GitHub."}}, {"@type": "Question", "name": "Was openGym written with AI?", "acceptedAnswer": {"@type": "Answer", "text": "openGym is developed with Claude Code, Anthropic's coding agent; a large share of the code, tests and docs is drafted that way, and every change is reviewed, tested and released by the maintainer. The app itself calls no AI service unless an admin switches on the optional AI coach."}}, {"@type": "Question", "name": "Where does the exercise database come from?", "acceptedAnswer": {"@type": "Answer", "text": "The exercise text lives in openGym's own catalogue in the repository, open to fixes and translations by pull request; the oldest entries came from ExerciseDB under MIT. The pictures and animations are licensed from Gym visual for use in openGym only and ship with it at 180 px. Reusing them anywhere else needs your own licence from gymvisual.com."}}, {"@type": "Question", "name": "What does the AGPL license mean for me?", "acceptedAnswer": {"@type": "Answer", "text": "You can self-host, use, modify and share openGym freely. Only if you run a modified version as a network service must you offer that version's source under the same license. Using or self-hosting it unmodified obliges you to nothing."}}]}-{"@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [{"@type": "Question", "name": "Is openGym really free?", "acceptedAnswer": {"@type": "Answer", "text": "Yes — free as in cost and as in freedom (AGPL-3.0). No pro tier, no locked features, no ads, and the license keeps every fork open source too."}}, {"@type": "Question", "name": "Is openGym on the App Store and Google Play?", "acceptedAnswer": {"@type": "Answer", "text": "The App Store: yes, since 23 October 2026, for iPhone and Apple Watch (https://apps.apple.com/app/id6822275400). Google Play is next; until then the signed Android APK is a direct download."}}, {"@type": "Question", "name": "Should I pick the mobile app or self-host?", "acceptedAnswer": {"@type": "Answer", "text": "To simply track your training: the mobile app. For data on your own hardware, synced across devices, with profiles for the people you train with: self-host with Docker. The backup file migrates everything between the two, or pair the app to your server."}}, {"@type": "Question", "name": "What's on the openGym roadmap?", "acceptedAnswer": {"@type": "Answer", "text": "A small, themed release roughly every two weeks: a session queue, programmes and phases, AMRAP/%1RM/5-3-1 progression, cardio intervals, then database storage (v1.4.0), better search, OIDC login and a trainer role. The full plan is in ROADMAP.md on GitHub."}}, {"@type": "Question", "name": "Was openGym written with AI?", "acceptedAnswer": {"@type": "Answer", "text": "openGym is developed with Claude Code, Anthropic's coding agent; a large share of the code, tests and docs is drafted that way, and every change is reviewed, tested and released by the maintainer. The app itself calls no AI service unless an admin switches on the optional AI coach."}}, {"@type": "Question", "name": "Where does the exercise database come from?", "acceptedAnswer": {"@type": "Answer", "text": "The exercise text lives in openGym's own catalogue in the repository, open to fixes and translations by pull request; the oldest entries came from ExerciseDB under MIT. The pictures and animations are licensed from Gym visual for use in openGym only and ship with it at 180 px. Reusing them anywhere else needs your own licence from gymvisual.com."}}, {"@type": "Question", "name": "What does the AGPL license mean for me?", "acceptedAnswer": {"@type": "Answer", "text": "You can self-host, use, modify and share openGym freely. Only if you run a modified version as a network service must you offer that version's source under the same license. Using or self-hosting it unmodified obliges you to nothing."}}]}++{"@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [{"@type": "Question", "name": "Is openGym really free?", "acceptedAnswer": {"@type": "Answer", "text": "Yes — free as in cost and as in freedom (AGPL-3.0). No pro tier, no locked features, no ads, and the license keeps every fork open source too."}}, {"@type": "Question", "name": "Is openGym in the App Store and on Google Play?", "acceptedAnswer": {"@type": "Answer", "text": "The App Store: yes, since 23 October 2026, for iPhone and Apple Watch (https://apps.apple.com/app/id6822275400). Google Play follows once a new developer account has finished its closed test. On Android the signed APK is a direct download in the meantime."}}, {"@type": "Question", "name": "Should I pick the mobile app or self-host?", "acceptedAnswer": {"@type": "Answer", "text": "To simply track your training: the mobile app. For data on your own hardware, synced across devices, with profiles for the people you train with: self-host with Docker. The backup file migrates everything between the two, or pair the app to your server."}}, {"@type": "Question", "name": "What's on the openGym roadmap?", "acceptedAnswer": {"@type": "Answer", "text": "A small, themed release every two weeks: the gym reminder and health data read back from the phone (v1.4.3), then programmes and phases, Google Play with a new progression engine, cardio, better search, password and OIDC accounts, a trainer role, wearables, and database storage after that. The full plan is in ROADMAP.md on GitHub."}}, {"@type": "Question", "name": "Was openGym written with AI?", "acceptedAnswer": {"@type": "Answer", "text": "openGym is developed with Claude Code, Anthropic's coding agent; a large share of the code, tests and docs is drafted that way, and every change is reviewed, tested and released by the maintainer. The app itself calls no AI service unless an admin switches on the optional AI coach."}}, {"@type": "Question", "name": "Where does the exercise database come from?", "acceptedAnswer": {"@type": "Answer", "text": "The exercise text lives in openGym's own catalogue in the repository, open to fixes and translations by pull request; the oldest entries came from ExerciseDB under MIT. The pictures and animations are licensed from Gym visual for use in openGym only and ship with it at 180 px. Reusing them anywhere else needs your own licence from gymvisual.com."}}, {"@type": "Question", "name": "What does the AGPL license mean for me?", "acceptedAnswer": {"@type": "Answer", "text": "You can self-host, use, modify and share openGym freely. Only if you run a modified version as a network service must you offer that version's source under the same license. Using or self-hosting it unmodified obliges you to nothing."}}]}</script></head><body class="topnav dock">@@@ -206,7 -205,7 +206,7 @@@<p>One codebase, three ways to run it. Everything below applies to all of them unless asection says otherwise.</p><table class="cfg">- <tr><td><b>Mobile app</b></td><td>The iPhone app (with the Apple Watch app) and the Android APK. No account, no server, no sync unless you want one: the phone <i>is</i> the account, data lives in the app's private storage, reminders are native notifications. Install and done, or <a href="#mobile-server">connect it to your server</a> later.</td></tr>- <tr><td><b>Mobile app</b></td><td>The <a href="https://apps.apple.com/app/id6822275400" rel="noopener">App Store app</a> for iPhone and Apple Watch, and a signed Android APK. No account, no server, no sync — the phone <i>is</i> the account, data lives in the app's private storage, workout-day reminders are native notifications. Install-and-done.</td></tr>++ <tr><td><b>Mobile app</b></td><td>The <a href="https://apps.apple.com/app/id6822275400" rel="noopener">App Store app</a> for iPhone (with the Apple Watch app) and the Android APK. No account, no server, no sync unless you want one: the phone <i>is</i> the account, data lives in the app's private storage, reminders are native notifications. Install and done, or <a href="#mobile-server">connect it to your server</a> later.</td></tr><tr><td><b>Self-hosted</b></td><td>Two Docker containers on your own machine. Adds passkey profiles, sync across devices, installable as a home-screen PWA, optional admin dashboard, web push notifications. The flavor for households and training groups.</td></tr><tr><td><b>Demo</b></td><td><a href="/demo/">The in-browser demo</a> — the real app seeded with example data, storing everything in your browser only. Useful to try before installing, and as a free plan editor (see <a href="#import">Import</a>).</td></tr></table>@@@ -249,21 -248,18 +249,21 @@@away, stays quiet. The missed-workout nudge, when switched on, is scheduled the same way.</p><h2 id="iphone">Use on iPhone</h2>- <p><b>openGym is in the App Store</b>, for iPhone and Apple Watch, in every App Store country:- <a href="https://apps.apple.com/app/id6822275400" rel="noopener">get it here</a>. It works on the- phone alone, or <a href="#mobile-server">paired with your own server</a>. Other ways:</p>+ <p>openGym has a native iPhone and iPad app, with an <b>Apple Watch</b> app, widgets, a Live+ Activity and Apple Health. It is the same app as on Android: use it on its own or connect it+ to your server.</p><ul>- <li><b>The App Store:</b> the app is on its way in. Until it is listed there, the- <li><b>Self-host + home screen:</b> open your own openGym instance in- Safari → <b>Share</b> → <b>Add to Home Screen</b>. You get a full-screen app with its- own icon, passkey sign-in and sync — no expiry, no fees.</li>- <li><b>Build it onto your own iPhone:</b> with a Mac and Xcode 15+, the native Capacitor- app runs on your device with a free Apple ID (Apple expires the signature after- 7 days; re-run from Xcode to renew — <b>AltStore</b> can automate that re-signing over- Wi-Fi). See <a href="https://github.com/DuarteSantos8/openGym/blob/main/docs/MOBILE.md" rel="noopener">docs/MOBILE.md</a>.</li>- <li><b>Just looking?</b> Try the <a href="/demo/">in-browser demo</a> — the real app with++ <li><b>The App Store:</b> <a href="https://apps.apple.com/app/id6822275400" rel="noopener">get it here</a>,++ in every App Store country. To try the next version early, the+ <a href="https://testflight.apple.com/join/RKATb61k" rel="noopener">public TestFlight beta</a>- is the same app: install Apple's TestFlight, open the link, done. Your data stays when- the App Store version replaces it.</li>++ is the same app.</li>+ <li><b>Self-host + home screen:</b> open your own openGym instance in Safari →+ <b>Share</b> → <b>Add to Home Screen</b>. A full-screen app with its own icon,+ passkey sign-in and sync.</li>+ <li><b>Build it yourself</b> (a fork, say): open <code>frontend/ios</code> in Xcode with a free+ Apple ID and run it on your phone (Apple expires that signature after 7 days). See+ <a href="https://github.com/DuarteSantos8/openGym/blob/main/docs/MOBILE.md" rel="noopener">docs/MOBILE.md</a>.</li>+ <li><b>Just looking?</b> Try the <a href="/demo/">in-browser demo</a>: the real app withexample data, no account and nothing to install.</li></ul>@@@ -1059,64 -976,14 +1059,63 @@@ Leg Day,Leg Press,2026-08-21,200,1</cod<h3>Is it really free?</h3><p>Yes — free as in cost <i>and</i> as in freedom (AGPL-3.0). No pro tier, no lockedfeatures, no ads, and the license keeps every fork open source too. If it replaced a- paid tracker for you, there's a <a href="https://buymeacoffee.com/duartesantos" rel="noopener">coffee button</a>- and a <a href="https://ko-fi.com/opengym" rel="noopener">Ko-fi page</a>,- though a star, a bug report or a pull request is worth just as much.</p>- <h3>Is it on the App Store and Google Play?</h3>+ paid tracker for you, there's a <a href="https://buymeacoffee.com/duartesantos" rel="noopener">coffee button</a>,+ a <a href="https://ko-fi.com/opengym" rel="noopener">Ko-fi page</a> and+ <a href="https://github.com/sponsors/DuarteSantos8" rel="noopener">GitHub Sponsors</a>+ (the app has all three under Settings → About & updates), though a star, a bug report or a pull request is worth just as much.</p>+ <h3>Is it in the App Store and on Google Play?</h3>- <p>The iPhone app (Apple Watch included) is on its way into the App Store; until it is listed,- the <a href="https://testflight.apple.com/join/RKATb61k" rel="noopener">public TestFlight beta</a>- is the same app. Google Play comes once a new developer account has run its closed test.- On Android the <a href="#android">signed APK</a> is the way in until then, and the same key- signs both, so moving to Play later keeps your data. The store apps are the same AGPL code,- with nothing collected and nothing to buy.</p>- <h3>How do I use it on my iPhone right now?</h3>- <p>As a web app: open your openGym address (it has to be <code>https://</code>) in- <b>Safari</b>, tap <b>Share → Add to Home Screen</b>, open the new icon and create your- profile; Face ID makes the passkey. It runs full screen, works offline and can send- notifications from there. The native App Store app is coming and can connect to the same- server, so nothing you log now is wasted. Just curious? The <a href="/demo/">demo</a> works- in Safari too.</p>+ <p>The App Store: yes, since 23 October 2026, for iPhone and Apple Watch- (<a href="https://apps.apple.com/app/id6822275400" rel="noopener">link</a>). Google Play is next;- until then the signed Android APK is a direct download, and it updates itself. The store apps are- the same AGPL code as everything else here.</p>++ (<a href="https://apps.apple.com/app/id6822275400" rel="noopener">link</a>). Google Play comes++ once a new developer account has run its closed test. On Android the++ <a href="#android">signed APK</a> is the way in until then, and the same key signs both, so++ moving to Play later keeps your data. The store apps are the same AGPL code, with nothing++ collected and nothing to buy.</p>++ <h3>How do I use it on my iPhone?</h3>++ <p>The easy way is the <a href="https://apps.apple.com/app/id6822275400" rel="noopener">App Store app</a>,++ on its own or connected to your server. Or as a web app: open your openGym address (it has to be++ <code>https://</code>) in <b>Safari</b>, tap <b>Share → Add to Home Screen</b>, open the new icon++ and create your profile; Face ID makes the passkey. It runs full screen, works offline and can++ send notifications from there. Just curious? The <a href="/demo/">demo</a> works in Safari too.</p>+ <h3>Passkeys don't work on plain http, or my laptop has no fingerprint reader.</h3>+ <p>Browsers only do passkeys over HTTPS (and on <code>http://localhost</code>), so+ <code>http://ip:port</code> never gets a passkey prompt, whatever you set. Put HTTPS in+ front (<a href="#sh-https">see above</a>, Tailscale Serve included, or a LAN certificate via+ <a href="https://github.com/DuarteSantos8/openGym/blob/main/docs/SELF_HOSTING_HTTPS.md" rel="noopener">SELF_HOSTING_HTTPS.md</a>).+ A fingerprint reader is not required: any passkey works, from your phone via the browser's+ QR code, a password manager, a security key or a Windows Hello PIN. Or switch on passwords+ with <code>PASSWORD_LOGIN=1</code> in <code>.env</code> and <code>docker compose up -d</code>:+ the sign-in screen then offers <b>Sign in with password</b> and new profiles can use one.</p>+ <h3>Can I use a password instead of a passkey?</h3>+ <p>Yes, if the instance allows it: <code>PASSWORD_LOGIN=1</code> in <code>.env</code>, then+ <code>docker compose up -d</code>. Off by default. The sign-in screen gets <b>Sign in with+ password</b> (profile name or sign-in e-mail), new profiles can use one, and a passkey profile+ adds one under <b>Settings → Account → Password</b>. openGym never sends mail, so a forgotten+ password is reset with a one-time code from the admin dashboard. Switching it off later locks+ out profiles that only have a password. <a href="#admin-signin">More on signing in</a>.</p>+ <h3>What is guest mode, and can I turn it off?</h3>+ <p><b>Continue without account</b> keeps everything in that browser: no profile, no sync,+ nothing on the server. Make a profile on the same device later and the data moves in. For an+ instance meant for a known set of people, <code>ALLOW_GUEST=0</code> removes the button;+ <code>INVITE_ONLY=1</code> decides who may create a profile. Stuck as a guest because sign-in+ never works? The <code>api</code> container isn't reachable (<a href="#sh-nas">NAS notes</a>).</p>+ <h3>The AI Coach doesn't show up on my server.</h3>+ <p>Nothing in <code>.env</code> switches it on; an admin does, in the app. If Settings →+ Account has no <b>Admin dashboard</b>, nobody is admin yet: copy <b>Settings → Account →+ Account ID</b> into <code>ADMIN_UIDS</code>, <code>docker compose up -d</code>, reload.+ Then <b>Admin dashboard → AI Coach → Set up the Coach</b>, connect a provider, test it, and+ the Coach appears in the menu at the top right of <b>Plan</b>.+ <a href="#coach-providers">More on providers</a>.</p>+ <h3>How do I serve it under /gym with nginx?</h3>+ <p>Either nginx passes <code>/gym/</code> through and <code>.env</code> has+ <code>BASE_PATH=/gym</code>, or nginx strips it and <code>BASE_PATH</code> stays empty;+ never both. <code>ORIGIN</code> has no path, and leave out <code>proxy_cookie_path</code>.+ A working config is under <a href="#sh-stack">Fitting it into an existing stack</a>.</p>+ <h3>Can I move my data from the phone app to my server?</h3>+ <p>Yes. Easiest: pair the app with the server (<a href="#mobile-server">how</a>) and answer+ <b>Add them</b> when it asks about this device's workouts. Or export a backup in the app+ (<b>Settings → Data & backup → Export backup</b>) and import it on the server, signed in,+ under <b>Settings → Data & backup → Import backup</b>; it asks before replacing anything+ the server has that the file doesn't.</p><h3>Mobile app or self-hosted — which one should I pick?</h3><p>If you just want to track your training: the mobile app. If you want your data on yourown hardware, synced across devices, with profiles for the people you train with: