Macrofit Dev Reference
App Logic — Visual Spec

Weekly Check-In Logic

Covers weekly check-in behavior, Macro Point (MP) adjustments, meal unlocking, and the full 24-week program cycle.

Core Behavior

Check-in immediately unlocks next week's meal selection

As soon as a customer completes their weekly check-in, the meal selection for the following week is unlocked. This is not delayed or batched.

MP adjustments are applied after check-in

Macro Point adjustments are calculated based on the check-in responses and applied to the next week's budget immediately after the check-in is submitted.

Adherence < 7 in dieting phase — adjust every other week only

During the dieting phase (first 16 weeks), if a customer's adherence score is less than 7, their Macro Points only adjust every other week instead of every week.

Program Phases (24-Week Cycle)

Dieting Phase — Weeks 1–16

Decreasing Macro Points

Fat loss adjustment: −1.5 MP per week

Body recomp adjustment: −1.0 MP per week

Low adherence (<7): Adjust every other week only

Breastfeeding bump: +10 MP per week (stacks on top of normal adjustment)

Reverse Diet Phase — Weeks 17–24

Adding Macro Points Back

Standard increase: +3 MP per week

Weight gain > threshold: Hold MP steady for 1 additional week (no increase)

Breastfeeding bump: +10 MP per week (still applies, stacks on top)

End of Week 23: Data assessed against beginning formula — beginning MP set for Week 25 to restart cycle

Macro Point Adjustment Rules

ConditionMP AdjustmentNotes
Fat loss — dieting phase−1.5 MP/weekStandard weekly decrease during weeks 1–16
Body recomp — dieting phase−1.0 MP/weekSlower decrease for body recomposition goal
Adherence < 7 — dieting phaseEvery other week onlyFull adjustment amount applied, just less frequently
Reverse diet phase+3 MP/weekStandard weekly increase during weeks 17–24
Weight gain > threshold — reverse dietHold (0 MP change)Holds steady for 1 week, then resumes +3/week
Breastfeeding — 'still breastfeeding' + 'drop in supply'+10 MP/weekStacks on top of normal adjustment. Applies every week the condition is reported.
End of Week 23Reset to beginning formulaMP for Week 25 set based on original intake formula to restart the 24-week cycle

Breastfeeding Bump — Stacking Rule

If a customer marks "still breastfeeding" AND "drop in supply" during their check-in, they receive a +10 MP bump for that week. This bump applies every week they report that condition and stacks on top of the normal weekly adjustment (it does not replace it).

Example: Week 5, fat loss goal, adherence ≥ 7, breastfeeding bump → −1.5 + 10 = net +8.5 MP

Cycle Restart at Week 23

At the end of Week 23, the system assesses the customer's data against the original beginning formula. Their Macro Points for Week 25 are set based on this assessment, effectively restarting the 24-week cycle. Week 24 is a transition week — the customer continues on their current MP while Week 25 is being calculated.

Week 23Assess against beginning formula
Week 24Transition week
Week 25New cycle begins

Macrofit Internal — App Logic Spec · For dev team use only