Day to Day
Pitfalls
The bad habits you're catching yourself on — logged one day at a time, with the goal of zero. Not a punishment ledger: awareness comes first, and the page exists to make the pattern visible.
The idea
A pitfall is a habit you're trying to stop — sugar, doomscrolling, whatever keeps tripping you up. You can track up to 6 at a time. Each day you log whether you stayed clean or slipped, and the goal is simple: zero. A clean day means the habit wasn't triggered.
Catching yourself is the whole point. A slipped day you logged honestly is worth more than a clean day you guessed at — the report can only show you a pattern it can see.
Setting up a habit
You do everything in the Pitfalls section of the Daily Log; the Pitfalls page is the read-only report. Add a habit with a name, an optional description (rich text, up to 1000 characters — shown behind Show description on the Pitfalls page), and a severity from Mild to Very Severe — it defaults to Moderate and sets how quickly the report bars turn red (more on that below). Tap the habit's name or description any time to edit or delete it.
Logging your day
Each habit shows two action cards for the day: Clean (Habit kept) and Slipped (Habit broken). Tap the active card again to clear the entry. Missed a few days? Open the Month history grid and tap any past day to cycle it: no entry → Clean → Slipped → cleared.
A cleared day means no data, not clean. The report treats untracked days as unknown — they don't count toward your clean days or break your streak, but they don't help it either.
Severity — how much a slip weighs
Not every habit is equally damaging, so each one carries a severity. Severity sets a monthly threshold — the number of slips in a month at which that habit's bar in the Monthly Report saturates to full red:
| Severity | What it means | Monthly threshold |
|---|---|---|
| Mild | Noticeable but causes little impairment. | 20 slips |
| Moderate | Clear impact on daily functioning. (the default) | 14 slips |
| Severe | Major impairment or significant distress. | 8 slips |
| Very Severe | Profound impairment; crisis-level impact. | 4 slips |
In practice: a Mild habit tolerates many slips before its bar looks alarming, while a Very Severe one saturates after only a few. Pick the level that matches the habit's real cost to you — it's what makes the red on the chart honest.
Reading the Pitfalls page
The Pitfalls page shows one habit at a time. Pick it with the Pitfall tracker selector — your choice is remembered per year — and the habit's name, severity badge and description appear below. Then come the numbers:
| Card | What it tells you |
|---|---|
| Clean streak | The hero: when your current run of clean days began, with a Day counter — "N clean days in — and counting." |
| Best Streak | Your longest clean run this year, in days. |
| Clean Days | Total clean days, out of all the days you've tracked. |
| Toughest / Easiest day | The weekday you slip most and least, with its break rate. Needs at least 14 tracked days — about two weeks — before a pattern is worth showing. |
| This month | Slips so far this month, measured against your severity threshold — how much room you have left, or how far past it you are. Shown when you're viewing the current year. |
| Over threshold | How many months this year hit or passed the threshold. Zero is green; two or more is red. |
The Monthly Report
Twelve bars, one per month, counting Breaks per month. Bar colour runs from green at zero slips toward red as a month approaches the dashed month threshold · N line — the severity threshold from the table above. Months with no data show a quiet dot instead of a bar, and future months sit dimmed.
The Month / Cumulative buttons in the report's header switch what the bars measure. They answer two different questions:
| Lens | What the bars show |
|---|---|
| Month (the default) | "Was this month bad?" Each bar is that month's slips on its own, coloured toward red as it approaches the dashed threshold line. |
| Cumulative | "How is the year adding up?" Bars become a running total from January onward, drawn in a single quiet colour with no threshold line — the curve is about trajectory, not a per-month verdict. A month you didn't track simply carries the total forward. |
Your choice is remembered per year. Severity itself doesn't change between the two — only the scale does, so switching lenses never re-grades a habit.
The Habit Log heatmap
Below the chart, a full-year calendar shows every single day for the selected habit: red for broken, a soft fill for clean, dimmed for no data, and a ring around today. Each month card carries its own tally, and the header sums the year — so you can see at a glance whether the red is clustering or thinning out.
Thinning out is the win. You won't go from daily slips to zero in a week — watch the Monthly Report bars shorten and the heatmap's red spread apart. That is progress, even while the count isn't zero yet.
Deleting a habit (via Delete in the edit dialog) clears all of that year's logged entries along with it — permanently. The confirm dialog says Delete forever and means it. If you're only pausing a habit, just stop logging it instead.