Skip to content

Announcements

One Log, Four Modules: How MuscleBuddy Connects What You Track

A weigh-in moves your calories. A run of bad recovery eases your training week. A declared condition changes your sessions. A map of what feeds what inside MuscleBuddy, and the reason each change carries.
Garrett Wilson
Founder, MuscleBuddy
3 min read

Plenty of fitness apps are separate tools that share a login. The workout tracker doesn't know you slept four hours, and the calorie counter doesn't know you trained legs, so you carry the information from one screen to the next.

MuscleBuddy connects them. Training, Nutrition, Health and Upkeep read from each other, so the thing you log in one place changes what you see in another. This post shows the map of those connections and walks through the ones you will notice first.

The map

This is every system in MuscleBuddy and the connections between them. Each dot is a part of the app you use, grouped by module. Each line is a place in the code where one of them reads another. Thicker lines carry more.

TRAININGNUTRITIONHEALTHUPKEEPPROGRESS & COMMUNITYMedications & upkeepConditionsFastingHabitsRecovery & readinessBloodworkScans & imagingCompounds & protocolsInsightsBody compositionCalorie & macro targetsDiet phasesMeal planningFood loggingMicronutrients & hydrationAdherenceExercise libraryProgram builderProgressionCardio & sportContest prepGymsRanks & benchmarksAvatarTurf & communityHealth tracking
Every system in MuscleBuddy, grouped by module. Each line is a place where one system reads another; thicker lines carry more.
List every system and what it connects to
A map of 26 MuscleBuddy systems across Training, Nutrition, Health, Upkeep, Progress & community, and the 129 connections between them.
SystemModuleConnects to
Medications & upkeepUpkeepCompounds & protocols, Conditions, Health tracking, Avatar, Bloodwork, Scans & imaging, Insights, Exercise library, Meal planning, Program builder, Ranks & benchmarks
ConditionsUpkeepHealth tracking, Exercise library, Program builder, Recovery & readiness, Avatar, Bloodwork, Cardio & sport, Compounds & protocols, Medications & upkeep, Micronutrients & hydration, Ranks & benchmarks, Gyms, Habits, Scans & imaging, Diet phases
FastingUpkeepCompounds & protocols, Recovery & readiness, Calorie & macro targets
HabitsUpkeepBloodwork, Conditions, Food logging
Recovery & readinessHealthConditions, Avatar, Bloodwork, Cardio & sport, Micronutrients & hydration, Program builder, Ranks & benchmarks, Adherence, Turf & community, Compounds & protocols, Fasting, Food logging, Health tracking, Insights, Exercise library, Diet phases, Progression, Calorie & macro targets
BloodworkHealthCompounds & protocols, Conditions, Scans & imaging, Exercise library, Micronutrients & hydration, Ranks & benchmarks, Recovery & readiness, Avatar, Cardio & sport, Habits, Health tracking, Medications & upkeep, Program builder, Progression, Calorie & macro targets
Scans & imagingHealthBloodwork, Compounds & protocols, Conditions, Medications & upkeep, Calorie & macro targets
Compounds & protocolsHealthBloodwork, Conditions, Scans & imaging, Medications & upkeep, Calorie & macro targets, Fasting, Insights, Ranks & benchmarks, Recovery & readiness
InsightsHealthAdherence, Exercise library, Progression, Ranks & benchmarks, Compounds & protocols, Meal planning, Medications & upkeep, Program builder, Recovery & readiness
Body compositionHealthProgram builder, Calorie & macro targets
Calorie & macro targetsNutritionDiet phases, Compounds & protocols, Meal planning, Program builder, Adherence, Bloodwork, Body composition, Turf & community, Fasting, Food logging, Scans & imaging, Contest prep, Ranks & benchmarks, Recovery & readiness
Diet phasesNutritionCalorie & macro targets, Adherence, Food logging, Program builder, Conditions, Meal planning, Micronutrients & hydration, Contest prep, Recovery & readiness
Meal planningNutritionFood logging, Calorie & macro targets, Health tracking, Insights, Medications & upkeep, Micronutrients & hydration, Diet phases, Program builder
Food loggingNutritionMeal planning, Health tracking, Diet phases, Program builder, Turf & community, Habits, Exercise library, Micronutrients & hydration, Recovery & readiness, Calorie & macro targets
Micronutrients & hydrationNutritionBloodwork, Conditions, Recovery & readiness, Cardio & sport, Food logging, Exercise library, Meal planning, Diet phases, Program builder, Ranks & benchmarks
AdherenceNutritionInsights, Diet phases, Progression, Ranks & benchmarks, Recovery & readiness, Calorie & macro targets
Exercise libraryTrainingConditions, Gyms, Health tracking, Program builder, Ranks & benchmarks, Bloodwork, Insights, Progression, Cardio & sport, Turf & community, Food logging, Medications & upkeep, Micronutrients & hydration, Recovery & readiness
Program builderTrainingCardio & sport, Conditions, Health tracking, Exercise library, Progression, Ranks & benchmarks, Avatar, Turf & community, Food logging, Gyms, Diet phases, Contest prep, Recovery & readiness, Calorie & macro targets, Bloodwork, Body composition, Insights, Meal planning, Medications & upkeep, Micronutrients & hydration
ProgressionTrainingProgram builder, Ranks & benchmarks, Gyms, Insights, Exercise library, Adherence, Avatar, Bloodwork, Cardio & sport, Turf & community, Health tracking, Recovery & readiness
Cardio & sportTrainingProgram builder, Conditions, Recovery & readiness, Bloodwork, Exercise library, Micronutrients & hydration, Contest prep, Progression, Ranks & benchmarks
Contest prepTrainingProgram builder, Cardio & sport, Diet phases, Calorie & macro targets
GymsTrainingExercise library, Health tracking, Program builder, Progression, Ranks & benchmarks, Turf & community, Conditions
Ranks & benchmarksProgress & communityAvatar, Exercise library, Program builder, Progression, Bloodwork, Turf & community, Conditions, Gyms, Insights, Recovery & readiness, Adherence, Cardio & sport, Compounds & protocols, Health tracking, Medications & upkeep, Micronutrients & hydration, Calorie & macro targets
AvatarProgress & communityRanks & benchmarks, Conditions, Health tracking, Program builder, Recovery & readiness, Bloodwork, Medications & upkeep, Progression
Turf & communityProgress & communityProgram builder, Ranks & benchmarks, Food logging, Gyms, Exercise library, Progression, Recovery & readiness, Calorie & macro targets
Health trackingHealthConditions, Exercise library, Program builder, Avatar, Food logging, Gyms, Medications & upkeep, Bloodwork, Meal planning, Progression, Ranks & benchmarks, Recovery & readiness

It's a dense map. For training, a handful of those lines matter most, and the sections below cover them.

Your weigh-ins move your calories

You log your weight. MuscleBuddy compares the average of your last seven weigh-ins with the seven before, so a salty dinner or a missed bowel movement doesn't read as progress or failure. When that trend moves outside the range your goal calls for, your calorie target moves, by 150 kcal a day unless your coach sets a different step, and the adjustment tells you what trend it saw.

That is the Health to Nutrition line on the map, and it keeps your targets matched to your body as your weight changes.

Recovery gates your training, over days

If you connect a wearable, your heart rate variability, resting heart rate and sleep feed one recovery score. Before you train, the readiness banner tells you where that score stands and why. On a single rough day that is all it does, and your session stays as written.

When recovery stays low for three or more days in a row, or falls steeply week over week, the program eases the whole training week so you can recover, and it says which of those two it saw. One tap undoes it if you disagree.

If you work with a coach, that deload goes to your coach's queue as a proposal, and they decide.

A condition you declare changes your sessions

Upkeep is where you track the things that run on longer clocks: medications, appointments, fasting, and conditions you manage. Declare a condition and its constraints reach your training. That can mean a different rest position, a narrower working range on a lift, or a sodium and fluid target alongside your plan. Each change is labelled with the condition that caused it, and you can undo it in one tap.

As with recovery, a coached member's adaptations go to the coach for review rather than applying on their own.

Training shapes when you eat

Log your training time and the meal planner places food around it, so the meals nearest your session carry more of your carbohydrate. If you fast, your eating window decides where the meals fall. Neither changes your targets, only when in the day you eat toward them.

Everything you log counts toward your ranks

Ranks, levels and streaks read from all four modules. Logged cardio and conditioning count toward your health rank. Grip and carry work count toward your forearm rank. Hitting your nutrition targets counts toward your nutrition rank. The progress side of the map shows the rest.

Every change says why

Each number you train and eat by comes from a rule you can read. When MuscleBuddy moves your load, eases your week or changes your calories, it gives the reason in plain language: a weigh-in trend, a stretch of low recovery, or a declared condition.

AI handles conversation and written summaries on top of that; it does not set the numbers.

Not medical advice

This post gives no medical advice. MuscleBuddy tracks conditions, medications and bloodwork so you and your clinician can see them next to your training. Decisions about treatment stay with the two of you.

See your own map fill in as you log.

Start free

Frequently asked questions

Does MuscleBuddy change my workout because I slept badly one night?
No. On a single rough day the readiness banner tells you where your recovery stands and why, and your session stays as planned. The training week eases only when recovery stays low for three or more days in a row or trends down steeply week over week, and the app says which of those it saw. One tap undoes it.
Can my coach override what the app changes?
Yes. If you train with a coach, a recovery deload or a condition adaptation arrives in their queue as a proposal instead of being applied, and they decide. A coach can override any suggestion the app makes for their client.
Does AI decide my weights and calories?
No. The numbers you train and eat by come from rules you can read, and every change carries the reason behind it in plain language. AI handles the coaching conversation and written summaries; it does not set the numbers.
Is the map in this post the real thing?
It is drawn from the connections in the code that runs the app, grouped under names a lifter would recognise. The names are ours and the grouping is simplified, but each line stands for real places where one part of the app reads another.

Garrett Wilson

Founder, MuscleBuddy

Garrett Wilson is the founder of MuscleBuddy, a longtime lifter and bodybuilder, and the engineer who built its training, nutrition, health and upkeep modules. He started MuscleBuddy out of his own spreadsheets, training seriously while managing health complications and autoimmune conditions with no product that would hold both halves at once. Where a guide here gives a health or training number, it cites the study the number comes from.

Get the guides by email

Training and nutrition guides, written the same way these pages are. No spam, and one-click unsubscribe on every email.

Track your sets and reps automatically with MuscleBuddy

Free workout logging and auto-progression, with coaching that adjusts to the sets and weigh-ins you log.

Create your free account