Why a GitHub-style heatmap is the best fitness graph you’re not using
Open any fitness app and you’ll find the same charts: a line for weight, bars for weekly steps, a ring for today. They all share one flaw — they’re built to summarize, and summaries are where your skipped days go to hide.
Developers solved this problem years ago, by accident. The GitHub contribution graph — that grid of green squares on every profile — turned out to be one of the most behavior-changing visualizations ever shipped. Here’s why it works so well for fitness, and why we built a whole app around it.
Averages lie, days don’t
A weekly average of 8,000 steps can mean two very different lives: a steady 8k every day, or three heroic 18k hikes surrounded by couch days. The line chart shows the same curve for both. The habit those two people are building could not be more different.
A heatmap has no aggregation to hide behind. Every day is its own cell, and an empty cell is visibly, uncomfortably empty. That discomfort is information — the exact information a habit needs.
The unit of fitness is the day
Nobody gets fit in a week or a workout. Fitness is the compound interest of hundreds of unremarkable days. A visualization should match the unit of the behavior it wants to change — and for exercise, that unit is the day.
One square per day also means a year fits on a phone screen. Zoomed out, you stop seeing workouts and start seeing seasons: the strong spring, the August slump, the comeback in October. Patterns you’d never spot in a scrolling list.
Green is a reward your brain understands
The contribution graph works because it converts effort into an immediate, cumulative, visual reward. Each active day physically darkens your wall. Streaks become visible objects you own — and losing one costs something you can see.
Psychologists call this the endowment effect: we defend what we already have more fiercely than we chase what we don’t. Thirty green squares in a row is something you have. That’s why a heatmap keeps you moving on days when motivation alone wouldn’t.
What this looks like in practice
Wall of Truth applies the contribution graph to your Apple Health data: steps, sleep, calories, exercise minutes, standing time and floors climbed each get their own wall. You define the thresholds, so the deepest green means whatever a great day means to you.
There’s nothing to log. Your iPhone and Apple Watch already record the data — the app just tells you the truth about it, one square at a time.
See your year on one screen — get Wall of Truth for iPhone.
Download on the App Store