Skip to content

TaskView is a self-hosted project and task management platform focused on clarity, ownership, and control. TaskView is built for teams that want a transparent, self-hosted alternative to SaaS task managers.

docs: calendar view

Daniel Barreto64047df497f2
diff --git a/docs/1.getting-started/1.index.md b/docs/1.getting-started/1.index.md
index fc51326..89daa70 100644
--- a/docs/1.getting-started/1.index.md
+++ b/docs/1.getting-started/1.index.md
@@ -21,6 +21,7 @@ You deploy it on your own server (or run it locally), and everything - tasks, pr
- **Tasks and subtasks** - create tasks with priorities, deadlines, notes
- **Kanban boards** - drag-and-drop tasks with custom statuses per project
- **Dependency graphs** - link tasks and visualize dependencies on an interactive graph
+- **Calendar** - see tasks by date in month, week and list views
- **Team collaboration** - invite members, assign roles with granular permissions, control who sees what
- **GitHub and GitLab sync** - connect repositories and import issues as tasks, kept in sync via webhooks
- **Financial tracking** - attach income and expense amounts to tasks for basic budget tracking
diff --git a/docs/1.getting-started/3.usage.md b/docs/1.getting-started/3.usage.md
index 332bbc0..b82155a 100644
--- a/docs/1.getting-started/3.usage.md
+++ b/docs/1.getting-started/3.usage.md
@@ -58,6 +58,10 @@ You can customize the columns - each project has its own set of statuses.
An interactive network graph showing how tasks connect to each other. Link tasks to define dependencies, then zoom out to see the big picture. Useful for planning complex work where order matters.
+### Calendar
+
+Tasks laid out by their start and end dates, in month, week or list views. Cards are colored by priority, so busy days and urgent work stand out. Useful for planning the week and keeping an eye on deadlines.
+
## Use the dashboard
![TaskView dashboard with widgets for today's tasks, upcoming deadlines, recent activity, and completed work](/docs/dashboard.png)
@@ -78,4 +82,5 @@ Use the global search (click the search icon or press `Ctrl+K` / `Cmd+K`) to fin
- [Learn about Kanban boards](/docs/features/kanban) - customize columns and workflow
- [Set up task dependencies](/docs/features/graph) - link related tasks on the graph
+- [Plan with the calendar](/docs/features/calendar) - see tasks by date
- [Invite your team](/docs/collaboration/members) - collaborate with others
diff --git a/docs/2.features/13.calendar.md b/docs/2.features/13.calendar.md
new file mode 100644
index 0000000..12d4131
--- /dev/null
+++ b/docs/2.features/13.calendar.md
@@ -0,0 +1,45 @@
+---
+title: Calendar
+description: See a project's tasks laid out by date in TaskView. Month, week and list views show deadlines and workload at a glance, colored by priority, on desktop and mobile.
+navigation:
+ icon: i-lucide-calendar-days
+---
+
+The calendar shows a project's tasks on the days they are scheduled. It answers questions a list can't answer quickly: what's due this week, which days are overloaded, and what's coming up next.
+
+## Opening the calendar
+
+Select a project in the sidebar, then click **Calendar**. On mobile, open the menu and tap **Calendar**.
+
+## Which tasks appear
+
+A task appears on the calendar when it has a **start date**, an **end date**, or both:
+
+- **Start and end date** - the task spans every day in between
+- **Only one date** - the task appears on that day
+- **A time** - the time is shown on the task card, in your local time zone
+
+Tasks without dates don't appear. To place a task on the calendar, open it and set a start or end date.
+
+## Views
+
+- **Month** - the whole month at a glance. Days with more tasks than fit show a "+N more" link.
+- **Week** - one column per day, with every task listed as a card. Best for planning the week. This is the default view on desktop. Saturday and Sunday shrink to a narrow column when nothing is scheduled on them.
+- **List** - the week's tasks grouped by day. This is the default view on mobile.
+
+Use **Today** and the arrows to move between periods. The selected view and period are kept in the page address, so a reload or a shared link opens the same place.
+
+Click a day number to jump to that week in the list view.
+
+## Reading a task card
+
+- **Color** - the task's priority: red for high, amber for medium, green for low
+- **Avatars** - who the task is assigned to
+- **Subtask count** - shown when the task has subtasks
+- **Strikethrough** - the task is complete
+
+Click a card to open the task details. Changes you make there show up on the calendar right away.
+
+## Permissions
+
+The calendar follows the project's existing permissions: you only see tasks you're allowed to see, and priority colors and assignees only appear if your role can view them.