README file from
GithubHabit Heatmap Calendar 📅
Track your daily habits at a glance. A clean, heatmap-style calendar for Obsidian that helps you stay consistent — no notes required.
✨ Features
- Multiple habits — Add as many as you want and switch between them
- One-click tracking — Click any day to cycle through:
Not tracked → Done → Missed - Year-at-a-glance — Full year heatmap with month grids
- Streak counter — See your current streak, total done, missed, and success rate
- Year navigation — Browse past years or jump back to today
- Zero clutter — All data stored in a single
data.json, no vault notes created
🚀 How to use
- Click the calendar icon in the ribbon or run the command "Open Habit Heatmap"
- Click + Add habit and give it a name
- Select your habit from the dropdown
- Click any day to toggle its state:
| Click | State |
|---|---|
| 1st click | ✅ Done |
| 2nd click | ❌ Missed |
| 3rd click | ⬜ Not tracked |
The stats bar updates instantly so you always know where you stand.

Manual
- Download the latest release from GitHub
- Extract the folder into
.obsidian/plugins/ - Enable the plugin in Obsidian settings
💾 Data
All your habits and history live in:
.obsidian/plugins/habit-heatmap-calendar/data.json
It's plain JSON — easy to back up, sync, or edit.
📄 License
MIT