Aurora Dashboard

Aurora Dashboard

A polished, interactive dashboard and control center for Obsidian — a grid of draggable, resizable widgets covering your clock, calendar, activity, tasks, capture, links, streaks, and more.

Features

• Draggable, resizable widgets on a configurable grid — set columns, row height, and gap to taste
• Edit mode — drag, resize, remove, and re-configure widgets, collapse them to a header bar, or reset the layout in one click
• Activity tracking — a GitHub-style heatmap of your note edits, with streaks, weekly, and lifetime totals
• Daily note integration — the calendar and Today widgets open, create, and manage your daily notes
• Vault-wide tasks — every open task from every note, grouped by source; click to jump, tick to complete
• Embed anything — a note, today's daily note, a .base, a Dataview query, a diagram, or markdown you type, rendered right on the dashboard
• Quick capture — send a thought to your inbox file or today's note in one keystroke
• Quick actions launcher — configurable buttons that run Obsidian commands, open notes, run searches, or insert notes from templates
• Link insights — see which notes are most-linked, which are orphans, and what links to your current note
• Habit & progress nudges — daily-note streaks, animated day/month/year progress rings, and a rolling habit tracker with per-habit streaks
• Custom accent color — theme the highlights, charts, and progress rings (with presets)
• Fully offline — all data lives in your vault, no external services

Widgets

Installation

The plugin isn't on the community plugin list yet. To use it:

1. Build it (npm run build) or download a release.
2. Copy the aurora-dashboard folder into <your-vault>/.obsidian/plugins/.
3. Restart Obsidian, then enable Aurora Dashboard under Settings → Community plugins.
4. Open it from the ribbon icon, the command palette (Open dashboard), or a hotkey you assign yourself in Settings → Hotkeys.

The plugin is not desktop-only: the dashboard renders as a single column on narrow screens and in edit mode the grip and the resize corner work with touch, so you can rearrange widgets on a phone or tablet with a mouse-free gesture. Install it on mobile the same way as any other plugin (community plugin list, or copy the folder into your vault).

Usage

• Open the dashboard — ribbon icon, the command palette, or a hotkey you assign in Settings → Hotkeys (search for “Aurora”). No default binding is set, so nothing collides with your own shortcuts.
• Edit the layout — click the pencil button in the dashboard's control bar (or run Toggle dashboard edit mode). Drag widgets by their grip, resize from the corner, use the gear for per-widget settings, the ✕ to remove, and the + to add new widgets. Cancel editing puts the layout back the way it was.
• Leave it open — the board follows the calendar on its own: at midnight the calendar, habits grid, heatmap and Today widget roll over to the new day without a reload.
• Work your tasks — the Today widget manages today's daily-note checklist; the All tasks widget lists every open checkbox task in your vault (any list marker; checkboxes inside code blocks are left alone). Click a task to jump to it in its note; tick the box to toggle it.
• Configure launchers — Quick actions and Pinned have their own editors (edit mode → gear): add, reorder, and remove actions or pinned notes.
• Track habits — the Habits widget's editor (edit mode → gear) names the habits you want to track and how many trailing days to show; click a square to mark that habit done for that day.
• Embed your own content — the Embed widget (edit mode → gear) shows a note by path, follows today's daily note, or renders markdown you paste in. Non-markdown files are transcluded, so a .base, an image or a canvas renders natively; long content scrolls or clips.
• Explore your links — the Backlinks widget follows the note you have open; Popular notes and Orphan notes rank your vault's connectivity.
• Quick capture — the Capture to inbox command, the send button in the control bar, or the Quick capture widget.
• Search — the search button in the control bar, or the Search widget.

Settings

All options live under Settings → Aurora Dashboard:

• Layout — columns, row height, gap, edit mode, reset layout
• Appearance — accent color with a picker and one-click presets
• Activity — toggle note-edit tracking and clear collected data
• Daily notes — folder and filename format (tokens: YYYY, YY, MMMM, MMM, MM, DD, dd, dddd, ddd). A format may include folders, e.g. YYYY/MM/DD; missing folders are created for you.
• Capture — target (inbox file vs today's note), folder, and inbox filename
• Pomodoro — default focus/break lengths used by new Pomodoro widgets

Many widgets also have per-widget options (edit mode → gear), e.g. how many entries to show, whether to include completed tasks, whether the week starts on Monday, or which actions appear on a Quick actions button.

Development

npm install
npm run dev        # watch mode, bundles to main.js
npm run build      # typecheck (tsc --noEmit) + production bundle

Smoke test — renders the dashboard in jsdom and runs assertions against every widget:

node smoke/build.mjs   # bundle the smoke test
node smoke/out.js      # run the checks (exit 0 = pass)

How it works

• src/registry.ts — widget type registration
• src/layout.ts — grid layout, collision detection, and overlap resolution
• src/widgets/*.ts — each widget is a self-contained module with a render function
• src/view.ts — the dashboard view: grid, drag/resize, edit mode, modals
• src/main.ts — plugin lifecycle, settings, commands, and activity tracking

License

MIT © 2026 Kerekes Stefan