A minimalist, elegant habit tracker for Obsidian that helps you build lasting habits with clear progress visualization.

Transform your Obsidian vault into a habit-building powerhouse. Track daily habits with an intuitive grid interface, customize your tracking experience, and watch your consistency streaks grow over time.

• Minimalist Look - Elegant, clean interface with nothing but essential functionality. Matches your theme effortlessly using Obsidian CSS variables
• Maximum configurability - You can tweak and customize pretty much every aspect of Habit Tracker 21 to make it just right for you
• Easy to setup - Matches your theme effortlessly using Obsidian CSS variables and includes sensible defaults for all tracker properties
• Smart Folder Support - Track individual files or entire habit folders
• Debug Mode - Comprehensive debugging gives you all the info you need to figure it out

1. Install the plugin from Obsidian's Community Plugins
2. Create your habits folder (e.g., Habits/)
3. Add habit files like Exercise.md, Reading.md for each habit you want to track
4. Insert tracker in your Daily notes template, or any other file:

```habittracker
{
  "path": "Habits"
}
```

That's it! Click the grid to log your daily habits.

By default, habit titles use the filename (e.g., Exercise.md → "Exercise"). Customize titles by adding frontmatter to your habit files:

---
title: "Morning Workout 💪"
entries: []
---

Examples:

• title: "📚 Daily Reading"
• title: "Drink 8 glasses of water"
• title: "Meditation & Mindfulness"

If no title is specified, the filename is used as before.

By default, habit colors inherit from your Obsidian theme's checkbox ticked color. Personalize individual habits with custom colors by adding a color property to your habit file frontmatter:

---
title: "Morning Workout 💪"
color: "#4CAF50"
entries: []
---

Examples:

• color: "#FF5722" (hex colors)
• color: "rgb(76, 175, 80)" (RGB values)
• color: "green" (CSS color names)

Invalid colors are ignored and the default theme color is used.

Access via Settings > Community plugins > Habit Tracker to set defaults for all trackers:

• Default Path - Choose from dropdown of vault folders
• Days to Show - Number input (default: 21)
• Debug Mode - Toggle debug output on/off
• Match Line Length - Fit tracker to readable line width

Override global settings in individual code blocks:

```habittracker
{
  "path": "Habits",
  "daysToShow": 30,
  "lastDisplayedDate": "2024-01-15",
  "debug": true,
  "matchLineLength": false
}
```

Track all habits in a folder:

```habittracker
{
  "path": "Habits"
}
```

Track one specific habit file:

```habittracker
{
  "path": "Habits/Exercise.md"
}
```

Show last 30 days:

```habittracker
{
  "path": "Habits",
  "daysToShow": 30
}
```

Override default color for entire tracker:

```habittracker
{
  "path": "Habits",
  "color": "#FF5722"
}
```

Hide streak indicators for cleaner view:

```habittracker
{
  "path": "Habits",
  "showStreaks": false
}
```

Show habits ending on a specific date:

```habittracker
{
  "path": "Habits",
  "lastDisplayedDate": "2024-01-15",
  "daysToShow": 30
}
```

Track habits for the entire month of November 2024:

```habittracker
{
  "path": "Habits",
  "firstDisplayedDate": "2024-11-01",
  "lastDisplayedDate": "2024-11-30"
}
```

Enable detailed logging:

```habittracker
{
  "path": "Habits",
  "debug": true
}
```

"Path is required" error

• Set a default path in plugin settings, or specify "path" in your tracker

Tracker shows "No habits found"

• Check the path exists in your vault
• Ensure folder contains .md files (subfolders are ignored)

Settings not updating

• Trackers auto-refresh when global settings change
• For JSON errors, check syntax (commas, quotes, braces)
• If issues persist, try force reload (Ctrl+R) or restart Obsidian

Debug Output Enable debug mode to see detailed logging in the browser console (F12).

git clone https://github.com/zincplusplus/habit-tracker
cd habit-tracker
npm install
npm run dev

PRs welcome! Please:

• Follow existing code style
• Update documentation

MIT License - see LICENSE for details.

Made with ❤️ for the Obsidian community