What is this?

The Execution Matrix is a fully interactive, science-backed workout tracker engineered to take you from your starting bodyweight to your target physique goal across 156 weeks (3 full years). It uses a 5-day ULPPL split — Upper Body, Lower Body, Push, Pull, Legs — based on peer-reviewed hypertrophy research.

Every feature in this app is intentional. Nothing is here for decoration. Each tool solves a real problem that derails natural bodybuilders from their long-term goals.

How to Start (3 Steps)

• Step 1 — Pick Your Week: On the left sidebar, tap any week number to load that week's full program. Start at Week 1 and move forward sequentially every week.
• Step 2 — Log Your Lifts: For every exercise card, type the weight you lifted in the lbs input box and press Log. The button turns green and your data is saved permanently to this device.
• Step 3 — Rest Timer: The moment you press Log, the app instantly analyzes the exercise and auto-starts the floating rest timer (3 mins for compounds, 1.5 mins for isolations). It beeps when it's time for your next set.

Important: Your logs are saved in your browser's local memory. Always use the same device and same browser every session to keep your full history intact.

Exercise Card — Every Button Explained

Element	What It Does
Sets × Reps	Your prescribed training volume for this exercise. This changes progressively across the 4 phases.
Target RPE	Rate of Perceived Exertion on a scale of 1–10. RPE 9 means you could do 1 more rep. RPE 10 means absolute failure. 🛡️ badge = CNS protection is reducing intensity by 1 this week.
Last Week	Instantly pulls the exact weight you logged for this exercise 7 days ago so you know exactly what target you need to beat.
Est. 1RM	Your estimated 1-Rep Max, auto-calculated using the Epley Formula the moment you log a weight. Watch this number grow over 156 weeks.
Sparkline bars	A tiny 4-bar trend graph beside the exercise name. The highlighted blue bar is this week. Instantly shows whether you are ascending, plateauing, or regressing.
▶ Tutorial	Opens a YouTube search for the exact exercise's form tutorial. Always watch before learning a new movement.
🔥 Warm-up Ramp	Calculates your exact 40%, 60%, and 80% warm-up sets based on your target weight, completely removing math from your session.
🔄 Alternative	Opens a popup with 2–3 evidence-based substitute exercises, each with its own YouTube video link. Use if equipment isn't available or an exercise causes discomfort.
⚡ Bolt Button	CNS Overshoot toggle. If you accidentally trained beyond your prescribed RPE (went to absolute failure on a moderate day), tap this bolt. It turns amber. Next week, the app automatically drops that lift's Target RPE by 1 to protect recovery.
⚠️ Plateau Badge	Appears automatically if you've logged the same weight for 3 consecutive weeks. Tap it to open a personalised coaching panel with 4 science-based strategies to break through.

Left Sidebar — Features Explained

Panel	What It Does
Week Buttons	Navigate all 156 weeks. Fully completed weeks glow GREEN. Your current active week is highlighted in BLUE.
Overall Journey	A progress bar tracking your % completion across all 156 weeks combined. Every logged exercise moves this bar forward.
⚡ Mesocycle Fatigue	Shows exactly where you are in your current 5-week mesocycle (4 weeks accumulation + 1 deload). The bar colour changes from GREEN to AMBER to RED as fatigue accumulates. Week 5 triggers the full Deload prescription.
🔥 Muscle Heatmap	Opens a visual status board of your muscles. It scans every exercise you've logged this week and shows whether your Chest, Back, Quads, etc., are Fresh, Recovering, or Highly Fatigued.
Morning Bodyweight	Log your daily scale weight (kg). This feeds directly into the Analytics chart as a second line, letting you track mass gain alongside strength over the entire 3 years.
View Strength Analytics	Opens the full Chart.js analytics modal. Select any exercise from the dropdown to plot your strength history. A second green line shows your bodyweight over the same period.

The Smart Coaching Systems

📊 Weekly Tonnage (Volume Tracker)

At the top of your active week, the tracker maintains a live calculation of your Total Weekly Volume (Sets × Reps × Weight). Watching your weekly tonnage climb from 30,000 lbs to 60,000+ lbs is the ultimate mathematical proof that you are building the muscle required to reach 70kg.

🔴 Plateau Detection (3-Week Rule)

If you log the exact same weight on any exercise for 3 weeks in a row, a glowing amber warning badge appears automatically. Tapping it opens a coaching modal with 4 personalised fixes: increase caloric surplus, use micro-loading (fractional plates), drop volume temporarily, or swap the exercise entirely.

⚡ CNS Protection Mechanism

Your Central Nervous System (CNS) is invisible but critical. If you ego-lift on a moderate day and push to absolute muscle failure when your program says RPE 8, you accumulate CNS debt. Tap the yellow bolt icon on that exercise. The tracker remembers this and silently reduces that lift's Target RPE by 1 the following week, ensuring your nervous system recovers before the next hard training block begins.

📊 Mesocycle Fatigue Ramp (RP Strength Science)

Based on Dr. Mike Israetel's RP Strength research, muscles can only accumulate productive training stress for 4–6 weeks before central and peripheral fatigue outweigh the growth stimulus. This tracker automatically structures your 156 weeks into 31 mesocycles of 5 weeks each. Weeks 1–4 are accumulation (progressively harder). Week 5 is a mandatory Deload Week — cut weight by 50%, do 2 sets max per exercise, keep RPE at or below 6. This is when muscles actually grow and connective tissue heals. Never skip it.

📈 Estimated 1-Rep Max (Epley Formula)

The 1RM badge uses the scientifically validated Epley Formula: 1RM = Weight × (1 + Reps/30). It assumes you completed the top of your prescribed rep range. Watch your estimated maxes on compound lifts break through landmark numbers (e.g., 225 lb Bench Press, 315 lb Leg Press) as your 3-year journey progresses.

The 4 Training Phases

Phase	Weeks	Focus	Key Changes
Phase 1: Rebuilding	1–26	Reconditioning	Technique mastery, joint health, sub-maximal loading. Learn every movement pattern perfectly before intensity increases.
Phase 2: Pure Bodybuilding	27–78	Max Hypertrophy	Volume peaks. Intensity techniques introduced (rest-pause, drop sets). Preacher Curls replace EZ Bar, Deficit RDLs added. Pull days get extra sets.
Phase 3: Heavy Bias	79–117	Strength / Power	Upper Day 1 switches to Barbell OHP + Weighted Pull-ups + Pendlay Rows. Lower Day 1 switches to Barbell Back Squats + Heavy Conventional Deadlifts. True powerbuilding begins.
Phase 4: Plateau Buster	118–156	Specialisation	Upper Day 1 becomes an Arm & Shoulder Blitz — Skullcrushers, Spider Curls, Lateral Raise Drop-Sets, Cable Kickbacks. Maximum detail work to hit the final physique target.

Note: At the first week of every new Phase, the Target RPE automatically drops by 1 (intro deload) to let your body adapt to the new stimulus before full intensity resumes the following week.

Analytics — Tracking Progress Over 3 Years

Tap "View Strength Analytics" in the sidebar at any time to open the dual-axis progression chart:

• Purple line (left axis) — Weight lifted in lbs for your selected exercise across all 156 weeks
• Green line (right axis) — Your morning bodyweight in kg over the same period

Use the dropdown to switch between Chest, Back, Legs, Shoulders, and Arms exercises. The chart is smart — it automatically maps Phase 3 strength swap exercises (e.g., OHP replaces Incline DB Press) so your progression line stays continuous across phase transitions.

Pro Tips for 3-Year Success

• Log bodyweight every single week — Seeing the green line rise on the chart while strength climbs is the most powerful motivation tool available over a 3-year timeline.
• Never skip the Deload Week — Your muscles don't grow during the hard weeks. They grow during Week 5 recovery. Skipping deloads is the #1 reason natural lifters plateau after 6 months.
• Use the Plateau Advice system early — A 3-week stall in Month 2 is trivially easy to fix. A 3-week stall in Month 18 that you ignored since Month 14 requires a full program reset.
• Watch the Tutorial before any new movement — Perfect form on Week 1 means zero injuries on Week 100. One torn rotator cuff can end an entire phase.
• Eat above maintenance every accumulation week — You cannot build muscle in a caloric deficit. Your target is a 300–500 kcal daily surplus during Weeks 1–4 of every mesocycle.
• Do not clear your browser cache — All 156 weeks of logged data live there. Re-upload the file to Netlify periodically as a cloud safety backup.
• Use the CNS bolt honestly — It doesn't matter what the number says. If your body felt destroyed after a set, tap the bolt. The program adapts for you.