The GymXP Guide

How the XP system, levels, streaks, ranks, and smart progression all work — so you can get the most from every session. New to the idea? Start with why a gamified workout app works.

⚡ XP

You earn XP for every set you log. The amount depends on the weight lifted, reps completed, the exercise's difficulty multiplier, whether you set a personal record, and your current streak tier.

Formula
base = weight × reps × multiplier × 0.1
xp = base × prBonus × (1 + streakBonus + nutritionBonus)

PR bonus: hitting a personal record on any set doubles the base XP (×2.0). The app compares every set to your all-time best for that exercise in real time.

Multiplier: each exercise has a difficulty multiplier — compound lifts like squat and deadlift carry higher multipliers than isolation movements.

Minimum: every set earns at least 1 XP, even if you're logging bodyweight or very low weight.

Example: 100 kg × 8 reps, multiplier 1.0, no PR, no streak = 80 XP. Same set on a 30-day streak = 80 × 1.35 = 108 XP.

🎮 Levels & Titles

All XP you earn contributes to your overall level. Each level requires more XP than the last — the curve steepens as you progress to reflect the increasing challenge of gaining strength over time.

Your level is shown on your profile dashboard and updates live at the end of every workout.
Levels Title XP per level (approx)
1 – 4🟤 Rookie160 – 380 XP
5 – 9⚪ Iron Starter480 – 900 XP
10 – 14⚪ Iron Warrior1,100 – 1,580 XP
15 – 19🔵 Steel Athlete1,830 – 2,480 XP
20 – 24🟤 Bronze Champion2,600 – 3,380 XP
25 – 29⚪ Silver Elite3,750 – 4,630 XP
30 – 39🟡 Gold Master5,050 – 8,150 XP
40 – 49🩶 Platinum Legend8,600 – 12,650 XP
50+💎 Diamond Titan13,100+ XP

🔥 Workout Streaks

Your streak counts consecutive days with at least one logged workout. The longer your streak, the higher your XP multiplier — rewarding consistency over time.

Your streak resets to zero if you miss a day, so keeping it alive becomes part of the game.

Days Tier Bonus
0 – 6 No Bonus +0%
7 – 13 Warming Up +10%
14 – 29 Consistent +20%
30 – 59 Dedicated +35%
60 – 89 Iron Will +50%
90+ Legendary +60%
Tip: even a single light session counts toward your streak. Rest days are fine — you don't have to train hard every day to keep the bonus alive.

🏅 Muscle Ranks

Every muscle group has its own XP total and rank, built up from the exercises that target it. This lets you see exactly where you're strong and where you've neglected training over time.

Muscle XP accumulates across all workouts — it never resets. Your rank reflects your total history with that muscle group.

Rank Label XP Required
E Unranked 0 XP
D Beginner 500 XP
C Novice 2,000 XP
B Trained 5,000 XP
A Advanced 12,000 XP
S Elite 25,000 XP
SS Legend 50,000 XP

Check your muscle ranks on the Profile screen — tap any muscle group to see its XP history.

🎯 Rep Ranges & Goals

Set your training goal in Settings and the app will guide your rep targets accordingly. During a session, if your reps fall outside the recommended range, the app suggests adjusting your weight up or down.

💪
Build Muscle
6 – 12 reps
Proven hypertrophy range. Take sets close to failure — the challenge drives the change.
Tone & Fitness
12 – 20 reps
Higher reps keep your heart rate up. Good form matters more than the weight.
🏋️
Get Stronger
3 – 6 reps
Heavy, low-rep work trains your nervous system to produce more force.
Custom rep range: in Settings → Current Focus → Custom, you can set your own min and max reps to override the goal-based suggestion entirely.

Your goal also affects the nutrition targets calculated by the TDEE calculator — each goal applies a different calorie and macro split suited to that outcome.

📈 Smart Progression

Every exercise shows your previous session's sets at the top of the card. The app analyses what you did last time and gives a specific suggestion for today — whether that's pushing for an extra rep, bumping the weight, or holding steady.

How suggestions are generated
SituationSuggestion
All reps hit top of goal rangeAdd 2.5 kg today 💪
Reps above goal rangeIncrease weight, target fewer reps
Reps below goal rangeAim for the minimum of your range
Reps increased vs last timeReady to add weight next session
Big rep drop-off within sessionReduce weight to keep reps consistent
Ramping weight patternTry doing all sets at your peak weight

Suggestions appear before your first working set (as a proactive card you can dismiss) and again after completing your sets as an overload hint at the bottom of the exercise card.

Double progression: the app uses a double progression model — first push your reps to the top of your goal range, then add weight. This is the most sustainable way to keep making progress over months and years.

🤖 AI Coach

The AI coach has full context of your training history — recent workouts, personal records, streak, XP, muscle ranks, and nutrition logs. Every answer is based on your actual data, not generic advice.

What the AI knows about you
Recent workoutsLast few sessions, exercises, sets and reps
Personal recordsAll-time bests per exercise
Workout streakCurrent streak length and tier
XP & levelTotal XP and current level
Muscle ranksXP totals and rank per muscle group
Training goalYour current focus and rep range
NutritionLast 7 days of macro results
ProfileBodyweight, height, age, activity level

Good things to ask the AI coach:

Free accounts get a limited number of AI messages. Premium unlocks unlimited coaching.

🥗 Nutrition & XP Bonuses

The Nutrition tab lets you log meals manually, search a food database, or scan a barcode. Hit your daily macro targets and you earn a bonus XP multiplier on your next workout.

Like workout streaks, you also build a nutrition streak — consecutive days where you've logged your food. The longer the streak, the higher the bonus.

Nutrition streak XP multiplier
0 – 2 days× 1.0 (no bonus)
3 – 6 days× 1.05 (+5%)
7 – 13 days× 1.10 (+10%)
14 – 29 days× 1.15 (+15%)
30+ days× 1.20 (+20%)

The nutrition bonus stacks on top of your workout streak bonus — so hitting both gives you the highest possible XP per set.

Targets: set your calorie and macro targets on the Nutrition → Targets screen. The TDEE calculator uses your bodyweight, height, age, sex, and activity level to give you a starting point based on your goal.

Questions? Email nichallsoftware@gmail.com

↑ Back to top