A habit heatmap shows you one full year of a tag: one row, 365 columns, each cell coloured by how many times you logged that tag on that day. Dark means more, light means less, empty means zero.
It's deceptively simple. But once you start reading your heatmaps, you start noticing things you never would have found by scrolling through individual entries.
The most obvious pattern is a streak, a run of consecutive days where you logged a tag. Streaks are motivating for habits you want to maintain: workouts, meditation, reading, early wake-ups.
But streaks also show you where things broke down. You can see exactly when a streak ended, and if you cross-reference other tags logged around that time, sometimes understand why. Travelled for work? Got sick? A cluster of "Poor sleep" entries just before the gap tells a story.
Heatmaps reveal weekly patterns that are invisible in day-by-day logging. If you look at your "Workout" heatmap and notice the columns of colour are always in groups of five with two gaps, you're looking at your weekly gym routine.
Or you might notice "Anxious" lights up every Sunday evening. Or "Coffee 3+" only appears on weekdays. These weekly cycles are deeply informative about how your environment shapes your behaviour.
This is where it gets interesting. Open two heatmaps side by side, say "Workout" and "Productive". Do the dark patches overlap? Or do they alternate? Does productivity follow exercise by one day, suggesting a lag effect?
You can't answer these questions by remembering. You can only answer them by looking at the data.
A heatmap also shows you when habits fade. A tag that was dark and regular in January that turns sparse by March is a habit that drifted. Seeing this isn't about guilt, it's about awareness. You can decide whether you want to bring it back or accept that it no longer serves you.
The key to useful heatmaps is consistent, honest logging. You don't need to log everything. Pick five to ten tags that matter to you. Log for a month. Then look at the heatmaps and see what they show you about your own life.
The patterns are already there. The heatmap just makes them visible.