Habits

Build streaks. Log daily habits. Watch your progress with charts, heatmaps, and printable reports — all stored as plain Markdown notes in your vault.

✨ Features at a glance

• 🎠 Carousel dashboard — log your habits from any note with a habits code block, with satisfying completion animations
• ✅ Three habit types — done/not-done, counted (8 cups of water), and timed (30 minutes of exercise, with +1/+5/+10 quick buttons)
• 🗓️ Daily, weekly, or monthly — pick a frequency per habit; weekly and monthly habits appear only on their due day, and streaks count consecutive weeks or months
• 🔥 Streaks and statistics — current and best streaks, completion rates, perfect days, weekly and monthly goals, per-habit heatmaps
• 📊 Charts on every habit page — 30-day activity and 12-week trend charts rendered in your theme's colours
• 📄 Printable PDF reports — pick your metrics, date range, and layout with a live A4 preview
• 📌 Sidebar quick-log panel — check off today's habits from anywhere, sized for narrow panes
• ⏸️ Pause without penalty — ill or travelling? Paused days never break streaks or drag down your stats
• 💬 Per-day comments — flip any card over to jot down why a day went the way it did; comments can be included in PDF reports
• 📅 Daily-note aware — a dashboard inside 2026-07-01.md shows that day's habits automatically
• 📱 Mobile friendly — responsive cards, long-press menus, and a configurable mobile layout
• 🌍 In your language — available in English, Spanish, French, German, and Simplified Chinese
• 🎨 Theme native — every colour comes from your theme; custom accents and icons per habit

📥 Installation

Habits is available in the community plugin browser: open Settings → Community plugins → Browse, search for "Habits", then install and enable. (BRAT and manual installation from the release assets work too.)

🚀 Quick start

1. Run the command Habits: Create habit and define your first habit.

2. Run Habits: Insert dashboard in any note (your homepage, or your daily-note template) to place the tracker:

   ```habits
   ```
   

3. Log your progress from the dashboard, or open the sidebar panel (ribbon icon or Habits: Open panel) to tick things off as you go.

📓 Your data stays yours

Each habit is a single Markdown note in a folder of your choice (default: Habits). The frontmatter defines the habit and stores one value per day — readable, portable, and future-proof:

---
habit: true
type: repetition
target: 8
unit: cups
icon: droplet
color: "#7c6cff"
startDate: 2026-07-01
weeklyTarget: 5
records:
  2026-07-01: 5
comments:
  2026-07-01: Managed all eight glasses before lunch!
pauses:
  - start: 2026-06-10
    end: 2026-06-14
---

No databases, no external services — delete the plugin and your history is still right there in your notes.

🗓️ Daily, weekly, and monthly habits

Every habit has a frequency, chosen when you create or edit it:

• Daily — due every day (the default).
• Weekly — due once a week on the weekday you pick. The card only appears on that day.
• Monthly — due once a month on the day you pick. Months shorter than the chosen day fall due on their last day, so the 31st always lands on the final day of the month (28th or 29th in February, 30th in April, and so on) — you never miss a month.

Weekly and monthly cards surface only on their due date in both the dashboard and the sidebar panel, so your list stays focused on what's actually due. Their streaks and stats count periods, not days: a weekly habit's streak is the number of consecutive weeks you completed it, and a monthly habit's is consecutive months. Days a habit isn't due don't count against its completion rate. To log a due date you missed, use the dashboard's date arrows to step back to it.

The charts on a weekly or monthly habit's page adapt too: instead of a 30-day grid, the activity chart plots each recent due date (labelled with the date it lands on), and a rolling completion-rate line shows the trend across periods. The summary tiles relabel accordingly — "Weeks completed" or "Months completed" rather than "Days completed".

🎠 The dashboard

Cards for each habit sit in a swipeable carousel. Completing a habit plays a celebration animation and the card glides to the back of the queue, keeping what's left front and centre. Click a card's name to open its note; right-click (or long-press on mobile) for editing, pausing, stopping, or removing.

Embedded in a daily note? The dashboard follows that note's date, so browsing yesterday's note shows yesterday's habits. The dashboard also live-updates whenever your habit notes or settings change — even from another pane or device sync.

Every card also has a comment flap along its bottom edge. Click it and the card flips over to a per-day comment box — perfect for noting why a habit was missed (or smashed). Days with a comment show an accent-tinted speech bubble, and comments follow the selected date, so each day keeps its own note.

📌 The sidebar panel

Open the panel from the ribbon icon or the Open panel command to log today's habits from anywhere: one compact row per habit with tap-to-check toggles, steppers, and slim progress bars, plus a running done/total count for the day.

📈 Stats and reports

The chart button opens the stats view: completion summary tiles, streaks, perfect days, goal progress, and a heatmap per habit over the last week or month (rolling or calendar).

From there, the download button opens the PDF export dialog:

• Metrics — summary tiles, completion trend chart, daily grids, goal progress, comments
• Range — this week, last 7 days, this month, last 30 days, or any custom range up to 92 days
• Layout — portrait or landscape, comfortable or compact, monochrome for ink-friendly printing
• Live preview — a to-scale A4 preview updates as you tweak; click it to inspect at full size. What you see is exactly what prints.

📊 Habit pages

Every habit note can chart its own history with a habit-metrics code block (new habit notes include one automatically):

```habit-metrics
```

Streak tiles, a 30-day activity chart with target line, and a 12-week completion trend — all in your theme's colours.

The block also works in any note: name a habit and its metrics render right there — perfect for journal entries, weekly reviews, or project pages. As you type after habit:, your habits are suggested automatically.

```habit-metrics
habit: Journal
```

⏸️ Pausing and stopping

• Pause a habit when life gets in the way. Paused days are skipped entirely: streaks survive, completion rates ignore them, and the card waits dimmed at the back of the carousel until you resume.
• Stop tracking a habit you've outgrown. It leaves the dashboard and stats but keeps its note and full history, with a one-click resume in its metrics view.
• Remove deletes the habit's note (to your trash) — the only destructive action, and it asks first.

⌨️ Commands

⚙️ Settings

🛠️ Development

npm install     # install dependencies
npm run dev     # build and watch during development
npm run build   # type-check and produce a production build
npm run lint    # check against the official Obsidian plugin guidelines
npm run release # bump patch version, tag, and push (CI drafts the release)

📄 License

MIT