⚡
GYM COACH
Personal Workout Tracker — User Manual
1. Introduction
Gym Coach is a personal workout tracking app designed for iPhone. It runs entirely in Safari as a PWA — no installation needed, works offline, and saves all data directly on your device.
Every session is smarter than the last: the AI planner automatically balances muscle groups based on your training history.
2. Deployment & Installation
Updating the app via GitHub
Go to your GitHub repository in a browser
Open the index.html file and click the ✏️ edit (pencil) icon
Replace all content by selecting all (Ctrl+A) and pasting the new file
Scroll down and click Commit changes
GitHub Pages automatically redeploys — wait ~60 seconds
💡 Tip: From your Mac you can also use git push from terminal for faster updates.
Installing on iPhone
Open Safari and go to your GitHub Pages URL (e.g. https://username.github.io/gymcoach)
Tap the Share button (rectangle with arrow) at the bottom of the screen
Tap Add to Home Screen
Confirm with Add — the ⚡ icon appears on your home screen
💡 Tip: Always open from the home screen icon, not directly from Safari, for the full-screen experience without browser bars.
Before every update — backup your data!
⚠ Important: Before committing a new index.html to GitHub, always open the app → History → ⬆ Export to save your backup. After the update loads, go to History → ⬇ Import to restore your data.
3. Home Screen
Stats Bar
Four cards show: Total sessions, Exercises in library, Total sets, and Last session date.
Muscle Group Filter
Tap one or more chips (Chest, Back, Shoulders, Arms, Legs, Core) to focus your session. With no chips selected, the session is full body.
Considerations Field
Describe physical limitations here (e.g. "L2-L3 stabilisation, avoid lower back load"). The planner automatically excludes risky exercises. Recognises English and Italian terms.
Start Session
Opens the Review & Edit planning screen where you approve your workout before it begins.
4. Review & Edit
Before every AI or Manual session, you can review and edit your exercise list. Plans start directly without this screen.
How the AI selects exercises
Groups trained recently get lower priority
Last 3 sessions carry a weighted penalty (100% / 60% / 30%)
Max 2 exercises per muscle group by default
Physical conditions automatically exclude risky exercises
Your training goal adjusts variety (Strength = fewer, Hypertrophy = more)
Modifying the plan
Tap ✕ to remove an exercise
Tap ⊕ Add exercise to add one from your library (searchable, alphabetical)
In Manual mode, the picker opens with multi-select — tap as many exercises as you want, then tap Add selected → to add them all at once
Customize & Regenerate
Type a request (e.g. "more upper body", "focus on chest") and tap ↺ Regenerate to get a new list instantly.
5. Session Queue
After confirming your plan, the app shows the Session Queue — a list of all exercises for this session. You choose which exercise to do and when, based on machine availability.
Queue overview
A progress bar at the top shows how far through the session you are
Three counters: Done (exercises completed), Remaining (still to do), Vol. kg (total volume accumulated: sets × reps × kg)
Each exercise shows its icon, name, sets × reps, muscles, and last saved weight
Starting an exercise
Tap any exercise in the list to open the workout screen for that exercise. The machine must be free — you decide the order.
After completing an exercise
When all sets are done, the app automatically returns to the Session Queue. The completed exercise disappears from the list.
Finishing the session
Tap Finish ✓ in the top bar at any time to end and save the session
When the last exercise is completed, the session ends automatically
6. Workout Screen
Exercise Card
Shows exercise name, sets, reps, and muscle tags. Tap ▼ Coach AI for expert technique notes personalised to your current weight.
Weight
The app recalls the last weight used. Type a new value and tap Update to change and save it.
Completing Sets
Tap ✓ Complete set N — the dot turns green
When all sets are done, you return to the Session Queue automatically
Postpone & Skip
⏭ Postpone — machine busy mid-exercise? Returns you to the Queue and moves this exercise to the bottom of the list with a "postponed" tag. It reappears when all others are done.
✕ Skip — removes the exercise permanently from this session and returns to Queue
Recovery Timer
Tap ⏱ Start Recovery Timer. Default is 90 seconds. Use − / + to adjust in 15s steps. Phone vibrates when time is up.
Choose Exercise
Tap ⊕ Choose exercise to manually pick a different exercise from your library. Search field + alphabetical list.
7. Session Complete
Summary shows exercises completed, total sets, and volume in tons (sets × reps × kg ÷ 1000). A 🏆 PR badge appears next to any exercise where you set a new personal record.
8. History
A line chart at the top shows weight progression for a selected exercise. Below, each session card shows date, time, exercises, sets, and volume. Tap to expand and see details.
Tap 🗑 Delete session to remove a session permanently
⬆ Export — download a JSON backup of all your data
⬇ Import — restore from a backup file
⚠ Important: Always Export before uploading a new version of the app to Netlify. Import after updating to restore your data.
9. Statistics
🔥 Week streak — consecutive weeks with at least one session
💪 Sessions — total sessions completed
⚡ Total tons — cumulative volume
📈 Weekly Volume — bar chart of last 8 weeks
🏋️ Muscle Groups — most trained groups
🏆 Personal Records — best weight per exercise
⭐ Top 5 Exercises — most frequent exercises
10. Profile
Personal Info
Name (used for home screen greeting), age, gender, height, weight, training goal, sessions/week target, target weight, and physical limitations.
Weight Log
Log your body weight anytime. A chart tracks your trend over time.
Progress Indicators
💪 Strength Trends — top exercises with weight trend and estimated 1RM (Epley formula)
🔥 Consistency — sessions vs weekly target, monthly count, streak
⚡ Volume Trend — last 4 weeks with Increasing / Stable / Decreasing label
🏋️ Muscle Balance — bar per group; "needs work" flag for untrained groups
Tap Save in the top bar to persist all changes.
11. Exercises
Add custom exercises with name, sets, reps, weight, and muscles. Tap ✕ to delete. The app comes with 50 pre-loaded exercises covering machines and cables.
12. Data & Privacy
All data is stored locally on your device. Nothing is sent to any server.
⚠ Note: Clearing Safari cache will erase all app data. Keep regular Export backups to protect your history.
12. Workout Plans
Workout Plans let you create and save custom exercise lists that you can reuse in any session. Ideal for structured programs like Push/Pull/Legs or Full Body A/B/C.
Accessing Plans
Tap 📋 Plans from the home screen Start New Session area
Or navigate directly from the Plans screen in the app
Creating a Plan
Tap + New plan and give it a name (e.g. "Full Body", "Push Day")
Add one or more lists — they are named automatically (List A, List B...) but you can rename them
For each list, tap ⊕ Add exercises — the multi-select picker opens. Tap all the exercises you want and tap Add selected →
Tap Save to store the plan
Using a Plan
Tap 📋 Plans from the home screen
Tap a plan card to expand it and see its lists
Tap ▶ Start next to a list — the session begins immediately with the Session Queue
Editing & Deleting
Tap ✏️ on a plan card to edit its name, lists, and exercises
Remove individual exercises from a list by tapping ✕ next to them
Delete an entire list with ✕ on the list header
💡 Tip: Plans are perfect for gym programs with rotating days. Create "Full Body A" and "Full Body B" and alternate between them each session.
13. Tips & Best Practices
Log your weight for every exercise — helps the AI improve suggestions over time
Update your profile goal and conditions whenever your situation changes
Export your data at least once a week if you train frequently
The muscle balance chart quickly shows if you are neglecting a group
Use Postpone instead of Skip when a machine is occupied — the exercise comes back later
If the planner keeps suggesting the same exercises, your training is well balanced — that is a good sign
⚡ Gym Coach — built with care for your training
by Pasquale Cataldo