What a Habit Heatmap Actually Tells You (That a Streak Cannot)

A streak is one number. It answers one question: how many days in a row, right now. Everything else about your habit — the month you were unstoppable, the fortnight you barely showed up, the fact that you have missed six Sundays in a row — is invisible to it.

A heatmap answers all of that at once. It is the same idea as the contribution grid on a GitHub profile: one small square per day, arranged in columns of weeks, shaded by how much you did. Fifteen weeks of it fits on a phone screen without scrolling, and it takes about two seconds to read.

How to read the grid

Each column is one week. Each row is one weekday, top to bottom. A square is dark if you did nothing that day and bright if you did. That is the entire notation, and it is worth learning properly because it means you read the grid in two directions.

Read across a row and you see one weekday over several months. Read down a column and you see one week. Almost everything useful in a habit log lives in one of those two axes, and a streak counter can express neither.

Three things a heatmap shows and a streak hides

1. Density, not just consecutiveness

Twenty-six days out of thirty is a strong month. If two of the misses were three days apart, your longest streak that month was eleven, and the counter currently says four. The grid shows a nearly solid block with two dark squares in it. Both descriptions are accurate. Only one of them will make you keep going.

This matters most right after a miss, when the counter drops to zero and the feeling is that the whole thing was fake. The research on missed days is fairly clear that one lapse does not measurably affect habit formation. The heatmap is the view that agrees with the research.

2. Which weekday you actually fail on

Look along the rows. Most people who track anything for two months find one row noticeably darker than the others, and it is almost never the day they would have guessed. Sunday is common. So is Wednesday, for reasons nobody can ever explain.

That row is the single most actionable thing in your whole log, because a weekday failure is a scheduling problem, not a discipline problem. You do not need more willpower on Sundays. You need a different version of the habit on Sundays, or a different time of day, or an honest decision that Sunday is off.

3. Whether the trend is up

Compare the left third of the grid with the right third. If the right side is denser, the habit is bedding in, and it is bedding in regardless of what the current streak says. If the right side is thinner, something has changed in your week — a new commitment, a moved schedule, a habit that has quietly grown too big — and it changed weeks before you noticed.

This is the part that surprises people. The decline shows up in the grid roughly a fortnight before it shows up as a broken streak, because you compensate for a while before you break.

A solid grid is not the goal

There is an obvious failure mode here and it is worth naming. Once the grid exists, a dark square starts to look like a flaw, and filling in squares becomes its own objective. That is the same trap as chasing the streak number, with better graphics.

A realistic grid for a habit you intend to keep for years has holes in it. Illness, travel, and the occasional evening where the sensible choice is to go to bed all leave dark squares, and none of them are failures. What you are looking for is not a solid block. It is a grid that is denser on the right than it was on the left.

What to do with it once a month

Two minutes, once a month, is enough:

• Find the darkest row. Decide whether that weekday needs a smaller version of the habit or an official day off.
• Compare the two halves. Denser on the right means keep going. Thinner means the habit is sized for a week you no longer have.
• Count the gaps of two or more. Single misses are noise. Two consecutive dark squares are the pattern worth interrupting.

If you are tracking several habits, run this on one grid at a time. Trying to read four of them at once is how a monthly review turns into something you stop doing, which is a topic of its own — how many habits you can actually carry is a shorter number than most people expect.

Streaky draws a fifteen-week heatmap for every habit, and any square in it can be tapped to toggle a check-in you forgot at the time. The streak tracker page has the rest of what it records, and the FAQ covers where the data lives, which is only ever on your phone.