Appearance
Habits
Habits are an optional page type for lightweight routines. They stay hidden until a workspace owner enables Habit in Settings → Workspace → Page 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
- Open Settings → Workspace → Page types.
- Enable Habit.
- Open Habits from the sidebar or create a new Habit from the page picker.
If you hide the Habit type again, the Habits page and widgets disappear for that workspace. Existing habit pages are kept.
Create a habit
A habit is a normal Aurora page with habit-specific properties:
| Property | What it controls |
|---|---|
| Cadence | Every day, Weekdays, Weekends, Weekly target, or Custom days |
| Weekdays | Which days count when the cadence is Custom days |
| 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 page 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 page 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 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 page to set an optional Reminder time and Reminder channels (In-app, Email, Push). AuroraCloud sends habit reminders, so they need an AuroraCloud workspace.
The reminder time is read on your own clock, using the timezone in Settings → Preferences → Dates & language (Aurora detects it when you sign in). A reminder arrives once a day at that time, only on the channels you ticked, and not at all on a day you have already checked in, skipped or paused the habit. With no channel ticked, all three are used.
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 pages.
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 you can keep your own copy of your habit data.
Plugin hooks
Plugins can subscribe to habit events through the plugin API:
habit:check-inhabit:uncheck-inhabit:streak-broken
These hooks let a plugin react when you check in or a streak breaks. See Building plugins for the plugin API.
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 page type is visible for the workspace
- the Habits 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 page itself.
