๐ŸŒ™

Ramadan AthleticTracker & Framework

๐Ÿ“‹ Working Prototype ยท Real Dataset ยท N=12 Athletes ยท Ramadan 2026

A data collection and AI-assisted coaching framework for fasting athletes โ€” built on real data from 12 athletes across a local gym during Ramadan 2026, and designed to scale with more participants.

๐Ÿ… Open the Tracker App ๐Ÿ“Š View Findings
12
Athletes Tracked
360
Diary Entries
7
Sports Covered
30
Days of Ramadan
About the Project

A framework, not a finished study

Muslim athletes lack practical, accessible guidance for training during Ramadan. Existing research is too scattered to be useful in real time. This project builds a framework that shows how structured daily data collection and AI-assisted coaching could work for this population โ€” prototyped well enough that someone could actually use or extend it.

We collected data from 12 athletes at a local gym during Ramadan 2026. N=12 is small, and we treat these findings as directional rather than definitive โ€” a foundation to map onto published datasets, not a standalone result.

๐Ÿ““
Daily Diary Methodology
Athletes logged 5 questions per day โ€” energy, recovery, hydration, sleep, and training completion. One of the findings was how hard it is to sustain this during Ramadan itself, which points directly to future design improvements.
๐Ÿค–
AI Coaching Interface
The coach gives responses that vary by sport, Ramadan week, and logged diary data. The decision rules are fully documented below โ€” making the logic transparent and reviewable rather than a black box.
๐Ÿ“Š
Python Analysis Notebook
10 sections of analysis covering training completion, energy and recovery trends, hydration and sleep impact, sport and intensity breakdowns, and individual athlete profiles. Available in the GitHub repository.
๐Ÿ”„
Designed to Scale
The infrastructure exists. What it needs is more data โ€” more participants, a longer observation window, and passive sleep data from iPhone Health to reduce the logging burden that made daily compliance difficult.
Key Findings

What the data shows

Four consistent patterns emerged across all 12 athletes. These are treated as directional signals to be mapped against published literature, not definitive conclusions.

๐Ÿ“‰

Energy dips in Weeks 1โ€“2, partially recovers by Week 4

The sharpest energy drop occurs in the first two weeks as the body adapts to fasting, with the lowest point around Week 3. By Week 4 athletes show measurable improvement โ€” consistent with published research on physiological adaptation during Ramadan.

+0.39
Wk1โ†’Wk4
๐Ÿ’ง

Dehydration was the most consistent daily challenge

42% of all diary entries reported noticeable dehydration, peaking at 51% in Week 1. High-intensity athletes hit 58%. The limited hydration window between iftar and suhoor is the structural cause โ€” post-iftar hydration protocols are the highest-impact intervention.

42%
dehydration rate
๐Ÿ˜ด

Fewer than half of athletes consistently met basic sleep thresholds

Only 52% of nights met 6+ hours. Week 2 was the worst at 44%. Days with adequate sleep produced recovery scores 0.6 points higher on average โ€” making sleep the strongest predictor of next-day recovery in the dataset.

52%
6h+ sleep rate
๐Ÿ”„

Athletes modified rather than abandoned training

61% of sessions were completed as planned, 24% were modified, and ~15% were fully skipped. This shows intelligent self-regulation. The implication for coaches is to build structured modification plans into the Ramadan training schedule rather than expecting full compliance.

61%
full completion
๐Ÿ“‹

Daily logging compliance was itself a challenge

Even athletes who wanted to participate found consistent daily logging difficult โ€” Tarawih, disrupted sleep, and normal training load all competed with it. This is a finding in itself: future versions need passive data collection (iPhone Health integration) rather than manual entry.

Design
implication
Note on sample size: N=12 is not sufficient to draw sport- or gender-specific conclusions independently. These findings are mapped against published literature on Ramadan and athletic performance. A larger study using this framework would need 40โ€“50+ participants for meaningful subgroup analysis.
Transparency

How the coach makes decisions

The AI coach gives advice that varies based on your sport, Ramadan week, and what you've logged. The decision logic is documented here so it's fully transparent and reviewable โ€” not a black box.

By Energy Level (logged daily)

ScoreWhat it meansCoach guidance
1โ€“2Very lowReduce session intensity ~40%. Prioritize mobility or light skill work. Flag to coach.
3ModerateMaintain planned session with modified rep ranges or reduced volume.
4โ€“5NormalProceed with full session. Monitor hydration closely post-training.

By Recovery Score (logged daily)

ScoreWhat it meansCoach guidance
1โ€“2PoorRest day or active recovery only. Do not stack consecutive low-recovery sessions.
3PartialLower-intensity session acceptable. Prioritize sleep window before next session.
4โ€“5FullNormal training load appropriate.

By Ramadan Week

Week 1 ยท Days 1โ€“6
Adapt
Reduce volume. Establish post-iftar hydration routine.
Week 2 ยท Days 7โ€“13
Settle
Sleep hit hardest. Shift session timing if possible. Prioritize sleep window.
Week 3 ยท Days 14โ€“20
Fatigue
Lowest avg scores. Recovery sessions over performance training.
Week 4 ยท Days 21โ€“27
Push
Gradual intensity rebuild. Maintain hydration discipline.
Week 5 ยท Days 28โ€“30
Finish
Conserve. Finish strong. Prepare for Eid transition.

By Sport & Intensity

GroupSportsCoach focus
High intensityTrack, Soccer, WrestlingAggressive hydration guidance, stronger intensity scaling, dehydration risk flagged early
Moderate intensityBasketball, Volleyball, SwimmingBalanced guidance, session timing relative to iftar
Lower intensityTennisMaintenance-focused, recovery optimization prioritized
Analysis Notebook

What the notebook covers

The Python notebook walks through 10 sections of analysis using pandas, matplotlib, seaborn, and scipy. Available in the GitHub repository.

๐Ÿ“Š
Training Completion
Breakdown of Yes / Modified / No by week and intensity group.
๐Ÿ“ˆ
Energy & Recovery Trends
Daily group averages with confidence bands and 7-day rolling averages across all 30 days.
๐Ÿ’ง
Hydration & Sleep Impact
Statistical comparison of performance on dehydrated vs. hydrated days and sleep-adequate vs. sleep-deprived nights.
๐Ÿƒ
Sport & Intensity Breakdowns
Violin plots and comparisons across all 7 sports and 3 intensity groups.
๐Ÿ”—
Correlation Heatmap
Full correlation matrix across all key variables โ€” day, energy, recovery, sleep, dehydration, and completion.
๐Ÿ‘ค
Individual Profiles
30-day performance arc for each of the 12 athletes with completion status marked day-by-day.
The App

How the tracker works

1

Set Your Profile

Enter your sport, training intensity, gender, and current Ramadan day.

2

Log Daily

Rate energy, recovery, training completion, hydration, and sleep. Data saves to your account.

3

See Your Trends

Your data overlaid on group averages โ€” by week, day-by-day, or by sport.

4

Ask the Coach

Get advice specific to your sport, week, and what you've actually logged.

5

Export

Download your full log as a CSV to share with your coach or for further analysis.

๐Ÿ…

Try the Ramadan Tracker

Set your profile, log your training days, and get guidance based on your sport, week, and logged data.

Open the Tracker โ†’