Calendar
Overview
The Calendar page shows task lists with due dates laid out on a monthly/weekly calendar. It gives members a visual overview of upcoming and overdue work without having to scan through the list view.
Who can see it
All authenticated members.
How it works
- Each task list with a due date appears as an event on its due date, displayed in the member’s local timezone.
- Clicking an event navigates to that task list’s detail page.
- Lists without a due date do not appear on the calendar.
- The calendar defaults to the current month. Members can navigate forward and backward by month.
Mine / All scope toggle
A Mine / All toggle appears above the calendar, controlling which lists are shown.
| Toggle | Who sees what |
|---|---|
| Mine | Only lists the member created or is assigned to |
| All | All lists the member has access to based on their role (Admin/Root see everything; User sees their accessible lists) |
Default by role:
- User — defaults to Mine
- Admin / Root — defaults to All
The selected scope is remembered while the member stays in the app. It resets to the role default if they switch to a different account.
Event color coding
Each calendar event is color-coded to reflect the current progress of that task list, matching the status indicators used throughout the app:
| Color | Status | Meaning |
|---|---|---|
| Gray (dashed border) | Not started | No items have been completed yet |
| Amber | In progress | At least one item has been started, but not all are complete |
| Teal | Completed | All items are marked complete |
| Gray diagonal stripe (italic text) | Scheduled — not yet created | A future recurrence slot that has not been activated yet (see below) |
Read-only lists (visible to a User who is not the creator or an assignee) appear at reduced opacity to signal that they cannot be interacted with.
Recurring list slots
For recurring task lists, the calendar shows both activated instances and scheduled slots — future periods that the system has not yet created a list for.
- Scheduled slots appear with a muted gray diagonal stripe and italic title to distinguish them from real lists.
- Clicking a scheduled slot shows an Activate Now option for any member who has permission to create task lists — this includes Admin, Root, Team Admin, and regular Users (for lists they own or are assigned to).
- Members without any list-create permission see no action when tapping a scheduled slot.
- Once a scheduled slot is activated — either manually or by the background job — it transitions to a normal calendar event and the striped appearance is removed.
Instances are created automatically as each recurrence period comes due. Manually activating a future slot does not skip or affect any other scheduled periods — each period still appears on its normal schedule.
Support notes
- If a list isn’t showing on the calendar, check that it has a due date set. Lists without due dates are intentionally excluded.
- If a member reports a due date appearing on a different day than expected, this is likely a timezone difference. Due dates display in each member’s local timezone — a date set by someone in one timezone may fall on a different calendar day for a member in a significantly different timezone.
- If a User says they can’t see a list on the calendar that another member can, check the toggle — they may be on Mine and not assigned to that list. Calendar visibility follows the same rules as the task list view.
- If an Admin or Root says they’re missing lists, check whether the toggle has been switched to Mine.
- If a striped slot and a real event appear on the same date for the same recurring list, this is a brief display artifact that resolves automatically when the background job next runs. No data is affected.