Habits

Habits are an optional object type for lightweight routines. They stay hidden until a workspace owner enables Habit in Settings -> Object types.

Aurora's habit tracker is intentionally small: it helps you check in, see patterns, and keep the data inside the same workspace as your notes, tasks, and calendar.

Turn habits on

1. Open Settings -> Object types.
2. Enable Habit.
3. Open Habits from the sidebar or create a new Habit from the object picker.

If the Habit type is hidden again, habit routes and widgets stop rendering for that workspace. Existing habit objects are preserved.

Create a habit

A habit is a normal Aurora object with habit-specific properties:

Property	What it controls
Cadence	Whether the habit is daily, weekly, or tied to specific weekdays
Weekdays	Which days count when the cadence is weekday-based
Check-ins	The stored history for each day
Daily target	Optional quantified target such as 2 L, 5 km, or 20 pages
Reminder time	Optional time-of-day reminder when you have not checked in yet
Archived	Whether the habit should stay out of active views

Open a habit like any other object to add notes, links, or supporting context.

Check in today

The Habits page shows a Today band with the habits due today.

Click the ring to toggle a normal done check-in. Use the ... action, or right-click the ring on desktop, to choose a specific state:

On phone-sized PWA layouts, you can also swipe a Today-row to keep the one-hand flow fast: swipe right to check in, or swipe left to remove today's check-in.

State	Meaning
Done	You completed the habit. Counts toward streaks.
Skipped	You planned not to do it. Does not punish the streak.
Missed	You tried or expected to do it and did not. Breaks the streak.
Paused	The habit is temporarily off. Does not punish the streak.

Planned absences, such as travel or sick days, are better represented as Skipped or Paused than as missed days.

Count quantified habits

Habits can have an optional Daily target and Unit. For example, a water habit can target 2 L, and a reading habit can target 20 pages.

When a target is set, the Today band shows a compact progress control instead of a plain ring. Use +1 to increment the count. The streak only treats the day as complete once the count reaches the target.

Read the 30-day strip

Each habit row includes a recent-history strip. It uses the same states as the Today band:

• filled green: done
• dashed or muted marks: skipped or paused
• red mark: missed
• empty: no entry for that day

The strip is meant for quick scanning. Open the habit object for the larger trend view.

Backfill past days

Forgot to check in yesterday? Click any cell in the 30-day heatmap strip to set or change the state for that day. A date-labelled state picker appears with the same options as today's check-in (Done, Skipped, Missed, Paused). The 7-day backfill strip on the Habits page also supports clicking past dates to retroactively record states.

This is useful for travel days, weekends, or any gap where you want to record what actually happened rather than leaving an empty cell.

Habit trends

On a habit's object page, Aurora shows a Trends panel with:

• a year heatmap
• current and longest streak
• 30-day completion rate
• best day of the week

Skipped and paused days are excluded from the completion-rate denominator, so planned absences do not make the habit look worse.

Quantified habits also shade heatmap cells by progress toward the target: partial days are visible, and target-complete days get the strongest fill.

Reminders

Open a habit object to set an optional reminder time and delivery channels. AuroraDocs reuses the existing notification infrastructure for in-app, email, and push reminders; it does not add a separate habit-only notification transport.

Reminders only run for workspaces where the Habit object type is visible, and the scheduler skips habits that are already checked in for that day.

Calendar integration

The Calendar page can show a compact habit summary in month cells, such as 3/4 habits for the selected day. Selecting a day opens a habit check-in panel alongside the rest of the day's calendar details.

Calendar overlays from external providers remain independent; habits are Aurora-native workspace objects.

Weekly reflection

The Habits page can show a lightweight weekly reflection card on the configured reflection day. It summarizes the past week, asks how it felt, and can save the reflection as a note linked back into the workspace.

The reflection loop is intentionally simple: no scoring, no AI summary, and no gamified habit grading.

Routine templates

The template gallery includes starter routine packs for common habit sets:

• Morning routine
• Focus sprint
• Wind-down

You can also save your current active habits as a custom routine template from the Habits page overflow menu.

Import and export

Use the Habits page overflow menu to export habits to CSV or import a matching CSV. The export includes habit metadata and flattened check-in logs so self-hosters and local-first users can keep an audit-friendly copy of their habit data.

Plugin hooks

Plugins can subscribe to habit events through the plugin API:

• habit:check-in
• habit:uncheck-in
• habit:streak-broken

These hooks let workspace-specific automations react to habit changes without AuroraDocs shipping those automations as core product behavior.

PWA shortcut

Installed PWAs expose a Today habits app shortcut when the platform supports manifest shortcuts. The shortcut opens /habits directly so mobile users can jump straight into today's check-ins from the launcher or app icon menu.

Right-panel widget

The built-in Habits widget can show today's due habits in the right panel when both of these are true:

• the Habit object type is visible for the workspace
• the Habits plugin/widget is enabled

The widget is a glance surface. It shows progress for today, up to five due habits, active-habit count, and top current streak. More detailed history stays on the Habits page and the habit object page.

Native mobile boundary

Native iOS and Android home-screen widgets belong to the separate henrikogaard/auroradocs-mobile repository. This main AuroraDocs repo covers the web app, installed PWA shortcut, and mobile-web swipe gestures.