Writing Tracker Heatmap Streaks

Writing Tracker Heatmap Streaks is an Obsidian plugin that tracks the new words you write each day, sends a webhook when you hit your goal, and shows your writing history in a compact heatmap sidebar with a detailed stats view.

Features

• Track daily new words instead of total file length.
• Send a webhook when the configured daily word goal is reached.
• View a sidebar heatmap with today's count and current streaks.
• Open a detailed stats modal with yearly history and monthly totals.
• Import past history from the obsidian-daily-stats plugin.

Installation

Install Writing Tracker Heatmap Streaks from Obsidian's community plugins browser:

1. Open Settings -> Community plugins in Obsidian.
2. Browse or search for Writing Tracker Heatmap Streaks.
3. Install and enable the plugin.

Usage

The plugin tracks your current daily word count in the status bar. The sidebar heatmap can be opened when needed, and each day is shaded based on how many words you wrote relative to your strongest writing day for that year.

Commands:

• Open writing heatmap
• Open writing stats
• Show today's word count
• Import history from daily stats plugin

Settings:

• Webhook URL: endpoint to call when the daily goal is met.
• Daily word goal: number of new words required before the webhook fires.
• Heatmap colour: choose one of the built-in color presets.
• Goal-met visual cue: show or hide the marker on days where the goal was reached.

When the goal is reached, the plugin sends a POST request with a JSON payload like:

{
  "event": "daily_word_goal_reached",
  "goal": 500,
  "actual": 512,
  "date": "2026-03-27",
  "timestamp": "2026-03-27T14:23:01.000Z",
  "test": false
}

Data and privacy

• Plugin data is stored in your vault under .obsidian/plugins/word-goal-webhook/data.json.
• The plugin makes network requests only when you configure a webhook URL. It sends POST requests only to the URL you enter when your daily goal is reached or when you click Send test webhook.
• Webhook payloads include the event name, configured daily goal, actual word count, date, timestamp, and whether the payload is a test.
• The daily-note word count import checks only the expected daily-note paths in the date range you choose. It does not enumerate every file in the vault.
• The plugin does not require an account, payment, ads, or telemetry.
• The source code in this repository is open source.

Development

npm install
npm run build
npm run deploy:runtime

npm run deploy:runtime copies only main.js, manifest.json, and styles.css into the local Obsidian plugin folder and removes development-only files from that installed copy. Set OBSIDIAN_PLUGIN_DIR to deploy to a different vault.

Create releases by pushing a version tag that matches the manifest version. The GitHub release workflow builds from source, runs tests, uploads main.js, manifest.json, and styles.css, and creates GitHub artifact attestations for those release assets.

License

MIT