The supplement consistency heatmap, and exactly how a square gets filled

Where the idea comes from

Jerry Seinfeld's calendar trick is the origin story that everyone repeats: do the thing, mark the day, and after a while the unbroken run of marks becomes the thing you protect. It survives as a method because it rewards repetition rather than perfection, and because the reward is visible without you having to remember anything.

The version developers know is the contribution grid: a year of days as a grid of squares, shaded by how much happened. Supplement Streak uses that shape for one reason. A list tells you about yesterday. A grid tells you about the year, and the year is the thing you actually wanted to know.

The rule that decides the shade

Each day has a number of planned intakes: every supplement multiplied by its daily times. The app divides the intakes you marked as taken by the intakes you planned, caps the result at one, and places it in one of five levels.

• Empty. Nothing logged that day, or nothing was planned.
• Level 1. You took something, but under a third of what was planned.
• Level 2. A third up to two thirds of the planned intakes.
• Level 3. Two thirds up to almost all of them.
• Level 4. Every planned intake taken. Only this level counts towards a streak.

The scale is proportional, not absolute, so a day with two planned intakes and a day with twelve are judged on the same terms. Adding a supplement makes it harder to fill a square, which is the honest outcome: you gave yourself more to do.

How the two streak numbers are counted

• Current streak. Consecutive complete days counting backwards from today. Today is treated as grace: if today is not finished yet, counting simply starts at yesterday, so an unfinished morning never shows your streak as broken.
• Longest streak. The longest run of consecutive complete days anywhere in your history. It only moves up, so it is the number that survives a bad week.
• Complete means all of it. A day joins a streak only when the day had at least one planned intake and you logged every one of them. Partial days still shade the heatmap, they just do not extend the chain.