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
README and ROADMAP: the store apps, the watch, and releases as they happened
Duarte Santos39d69c1d763d
diff --git a/README.md b/README.mdindex 87eeacfa4..dd8d80d6a 100644--- a/README.md+++ b/README.md@@ -23,6 +23,7 @@ on your phone, synced across your devices, behind your own passkey login.[Website](https://opengym.ch) ·[Live demo](https://opengym.ch/demo/) ·+[iPhone beta](https://testflight.apple.com/join/RKATb61k) ·[Android APK](https://github.com/DuarteSantos8/openGym/releases/latest) ·[Self-hosting guide](docs/SELF_HOSTING.md) ·[Roadmap](ROADMAP.md) ·@@ -113,6 +114,13 @@ if you want to try it before installing anything.- 19 languages, including right-to-left Arabic and Traditional Chinese. Exercise names andinstructions are translated for most of them.+**On the phone and the wrist**++- Apps for iPhone, iPad and Android that work on their own (no server, no account) or connected to+ yours. Rest timer in the notification shade, reminders, and Health Connect or Apple Health.+- An Apple Watch app: tick off sets with the Digital Crown, a full-screen rest countdown, heart+ rate per set, and complications. Widgets and a Live Activity on the iPhone.+**Optional extras, off by default**- An [AI coach](docs/AI_COACH.md) that drafts a week of routines and later suggests changes based on@@ -185,16 +193,18 @@ variable. The [self-hosting guide](docs/SELF_HOSTING.md) covers every option in## 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). Each build sits next to its `.sha256`, and- the app checks for updates itself. openGym is deliberately not on the Play Store.-- **iPhone:** Apple doesn't allow installs outside the App Store. Self-host and add the PWA to your- home screen from Safari, or build the native app onto your own device with Xcode.+| | 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) |+| **Android** | The signed APK from the [latest release](https://github.com/DuarteSantos8/openGym/releases/latest) or [opengym.ch](https://opengym.ch). From v1.4.2 in two sizes: **Standard** (animations at 180 px) and **HD** (360 px, a bigger download). It updates itself |+| **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 and HD) without losing data. Details, building it+yourself and connecting to your server: [docs/MOBILE.md](docs/MOBILE.md).## How it works@@ -206,11 +216,15 @@ Details and build instructions: [docs/MOBILE.md](docs/MOBILE.md).</p>- **`frontend/`** is React 19 and Vite (React Router, Zustand), built to static files inside Docker.-- **`api/`** is plain `node:http` with two dependencies: `@simplewebauthn/server` for passkeys and- `web-push` for notifications. Everything is stored as JSON under `./data`.+- **`api/`** is plain `node:http` with three dependencies: `@simplewebauthn/server` for passkeys,+ `web-push` for notifications and `undici` for the AI coach's provider calls. Everything is+ stored as JSON under `./data`.- **`web/`** builds the frontend and serves it with nginx, proxying `/api` so the whole app sits onone origin, which passkeys require.+The [architecture overview](docs/ARCHITECTURE.md) has the longer version, with diagrams of the+frontend, sync, the exercise media and the watch.+The training logic (progression rules, 1RM, how a logged session is read back) lives in purefunctions under `frontend/src/lib/` with tests beside them. The HTTP API is documented as anOpenAPI spec in [`api/openapi.yaml`](api/openapi.yaml), browsable at@@ -267,18 +281,14 @@ The [documentation index](docs/README.md) sorts every guide by who it's for. TheA release roughly every two weeks, each small and themed. The full plan is in[ROADMAP.md](ROADMAP.md), and the issues sit in the-[GitHub milestones](https://github.com/DuarteSantos8/openGym/milestones). The next two releases-finish the community wishes, then comes a new exercise database and a themed release every-two weeks after it.+[GitHub milestones](https://github.com/DuarteSantos8/openGym/milestones).| Release | When | Theme ||---|---|---|-| v1.3.10 | released Oct 2026 | New design, rotation, swipe actions, safer sync |-| v1.3.11 | next | Fixes, about thirty community pull requests, Health Connect, measurements |-| v1.3.12 | Nov 2026 | Community features: focus view, widget, timer rework |-| v1.4.0 | Nov 2026 | A new exercise database |-| v1.4.1 to v1.4.4 | Dec 2026 and Jan 2027 | Programmes, the progression engine, cardio |-| v1.4.5 to v1.4.10 | Jan to Apr 2027 | Search, accounts, the iOS app, Android and health, looks |+| v1.4.0 | released Oct 2026 | A new exercise database with 5,632 exercises, plus two rounds of community work |+| v1.4.1 | released Oct 2026 | Bug fixes for v1.4.0 |+| v1.4.2 | Oct 2026 | The App Store, the Apple Watch, widgets, a Google Play build |+| next | Nov 2026 to Apr 2027 | Programmes, the progression engine, cardio, sharing, accounts, Android and health, looks || later | | Database storage |## Communitydiff --git a/ROADMAP.md b/ROADMAP.mdindex 5c440a61f..31a17e9a5 100644--- a/ROADMAP.md+++ b/ROADMAP.md@@ -11,9 +11,9 @@ the next release is the last published one plus one patch (1.3.7 → 1.3.8), andreserved for a step as big as the new exercise database (v1.4.0).- Milestones: https://github.com/DuarteSantos8/openGym/milestones (every open issue sits in exactly one)-- Tracks, in order: the new exercise database with the community round (v1.4.0) → programmes → the- progression engine → cardio → sharing and gyms → accounts → the iOS app → Android and health →- looks and social, with database storage after that+- Tracks, in order: the new exercise database with the community round (v1.4.0) → the store apps+ (v1.4.2) → programmes → the progression engine → cardio → sharing and gyms → accounts → Android+ and health → looks and social, with database storage after that---@@ -149,27 +149,49 @@ server.- Still open from the old v1.3.12 list: the timer rework (#165), a home-screen widget (#299) anddistance for cardio (#177), now in their own milestones below-## v1.4.1: Programmes & phases (2026-11-29)+## v1.4.1: Bug fixes for v1.4.0 (released 2026-10-10)++Smooth animations on real phones, the update check asking GitHub again, the rest bell over music,+the Coach's own button on the Plan page, and the first round of reports on the new database.++## v1.4.2: openGym in the App Store (planned for 2026-10-18)++Not on the old plan: the store apps came forward because they were ready.++- The iPhone app in the App Store, with a public TestFlight beta before it+- An Apple Watch app, Home Screen and Lock Screen widgets, a Live Activity, Apple Health+- Sharper animations to download in the store apps; the APK in two sizes, Standard and HD+- A Google Play build, ready for the closed test Play asks of new accounts+- Delete your account in the app, the Coach asks before anything leaves, five reported security+ holes closed++## What comes next++The blocks below were planned and given milestones before v1.4.1 and v1.4.2 became the bug-fix+and store releases, so their milestones still carry the old numbers (v1.4.1 to v1.4.10). The order+stands; the numbers move when the milestones are renumbered. Each heading names its milestone.++## Programmes & phases (milestone v1.4.1, 2026-11-29)- Programmes: routines grouped into a named block over weeks, with deload and rest weeks, severalper profile (#159, GitLab !98; Discord "Programme mode", "folders", "major good ideas" 1)- Session phases (mobility / work / accessory / cooldown) with completion-only exercises forstretching that stay out of volume and PRs (#57, #140; Discord "non-typed exercises")-## v1.4.2: Progression engine I (2026-12-13)+## Progression engine I (milestone v1.4.2, 2026-12-13)- Rep or set ranges per set and AMRAP targets beyond the "to failure" flag (#154; Discord "Moretypes of sets"); the flag itself and triple progression came early in v1.4.0 (#179)- Assisted exercises as negative added weight (#176); the multi-formula 1RM came in v1.4.0 (#155)-## v1.4.3: Progression engine II (2026-12-27)+## Progression engine II (milestone v1.4.3, 2026-12-27)- Load as %1RM or auto with a stored training max, target RPE/RIR (#153)- Wave / percentage progression, 5/3/1 style (#70; PR #168)- A warm-up generator that picks the ramp from load and lift (#156)- Periodisation extras on top: mesocycle blocks, auto-regulation on RPE (#120)-## v1.4.4: Cardio, alternatives, groups (2027-01-10)+## Cardio, alternatives, groups (milestone v1.4.4, 2027-01-10)- Cardio: intervals (rounds × work/rest), interval programmes such as C25k, rucking as distance +pace + load, distance for cardio (#132, #169, #177; Discord "cardio programs", "rucking");@@ -178,7 +200,7 @@ server.(#110)- Complexes and interval groups beside supersets (Discord)-## v1.4.5: Sharing, gyms, admin (2027-01-24)+## Sharing, gyms, admin (milestone v1.4.5, 2027-01-24)- Search itself was rebuilt in v1.4.0 (#192); left here: searching your own history and importaliases by name@@ -187,13 +209,13 @@ server.shared (Discord "How to deal with different gyms")- Admin: per-user export, invite management, audit log filters-## v1.4.6: Accounts: password & OIDC (2027-02-07)+## Accounts: password & OIDC (milestone v1.4.6, 2027-02-07)- Optional username + password login next to passkeys (#118; Discord "Basic login", thepassword-manager thread), shipped early in v1.3.9, behind `PASSWORD_LOGIN`- OIDC login for PocketID / Authelia-style setups (#130, #72; GitLab !132 is the candidate)-## v1.4.7: Trainer & MCP write (2027-02-21)+## Trainer & MCP write (milestone v1.4.7, 2027-02-21)- Personal-trainer role: invite students by code, open a student read-only, write their plan (#119,GitLab !79; Discord "Trainer & Student Management")@@ -201,13 +223,14 @@ server.for hosted AI clients (GitLab !88)- Switching kg ↔ lb converts stored values instead of relabelling them (#22)-## v1.4.8: iOS app (2027-03-07)+## iOS app (milestone v1.4.8, 2027-03-07)- App Store / TestFlight build of the existing Capacitor target, HealthKit weight and workoutexport, the Home Screen icon and timer-sound issues gone for good (#90; Discord "Google Health")-- Apple Watch rest timer later, once the app is in the store+ (shipped in v1.4.2)+- Apple Watch rest timer later, once the app is in the store (a full watch app shipped in v1.4.2)-## v1.4.9: Android & health (2027-03-21)+## Android & health (milestone v1.4.9, 2027-03-21)- Health Connect for weight and sessions (Discord "Use health connect", pulled forward into v1.3.11); Withings and other scales(#127)@@ -221,7 +244,7 @@ server.- Firefox-on-Windows QR and third-party passkey providers stay documented, not fixed: platformbehaviour (#103, #101)-## v1.4.10: Looks, social, plugins (2027-04-04)+## Looks, social, plugins (milestone v1.4.10, 2027-04-04)- Skins alongside the accent colour, backgrounds as part of a skin, a big-screen layout (#129,#134, #135)