super-productivity/docs/wiki/4.04-Schedule-View.md
Jon Kilroy d5afe62016
feat(schedule): add a single-day view to the Schedule tab (#9058)
* feat(schedule): allow 'day' as a persisted time-view mode

* feat(schedule): compute single-day range and header for day view

* feat(schedule): add day-view toggle and single-day labels

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JzGvAaeT2TrZcEUA6fYPSZ

* docs(schedule): note the day view mode in the Schedule wiki

* fix(schedule): make the day-view header compact and locale-aware

Address review feedback on the single-day view:

- Build the day title with a locale-aware Intl skeleton instead of a
  hardcoded 'EEE, MMM d, yyyy' pattern, which pinned en-US field ordering.
- Shrink the title responsively so it never gets ellipsis-clipped: show
  the full weekday + date + year on roomy widths, and fall back to a
  compact month + day below TABLET, where the toggle group and nav
  controls leave too little room. The weekday still shows in the
  day-column header.
- Rename the .day-view-btn test hook to .e2e-day-view-btn per convention.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* refactor(schedule): rename week-month-* classes to time-view-*

The toggle group now has three buttons (Day, Week, Month), so the
week-month-selector / week-month-btn names no longer describe it. Rename
to time-view-selector / time-view-btn. Pure CSS class rename, no behavior
change.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* refactor(schedule): complete time-view-* rename in zen theme

The class rename left zen.css targeting .week-month-*, so its overrides
matched nothing. The :not(.active) rule is the load-bearing one: its
!important suppresses the toggle's hover highlight, which zen exists to
strip.

Co-authored-by: Jon Kilroy <jkusa@users.noreply.github.com>

---------

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
Co-authored-by: Johannes Millan <johannes.millan@gmail.com>
Co-authored-by: Jon Kilroy <jkusa@users.noreply.github.com>
2026-07-17 16:00:08 +02:00

3.6 KiB

Schedule View

The Schedule view shows a time-based timeline of how your planned tasks unfold over time. It distinguishes between scheduled tasks (shown at specific times) and regular tasks (flowing around fixed events), helping you see how work fits into your day.

What the Schedule Shows

The Schedule automatically generates a timeline from your tasks using the time estimates you've assigned. It shows the upcoming 30 days and displays:

  • Scheduled tasks — Tasks with a specific due time, shown at that time
  • Regular tasks — Tasks without a fixed time that "flow" around scheduled events
  • Recurring task projections — Instances of repeating tasks (see 4.13-Repeating-Tasks)
  • Tasks planned for specific days — Tasks you've assigned to certain days
  • Calendar events — Events from external calendars you've connected

Scheduled Vs Regular Tasks

The Schedule treats tasks in two ways:

  • Scheduled tasks — Have a specific date and time. They appear at that time on the timeline.
  • Regular tasks — Have no specific time. They flow around scheduled tasks, using your time estimates to show how they might fit into the day.

If you set work start and end times in settings, regular tasks are only shown within that range—they never appear outside your configured work day.

When planned work no longer fits into the available time for a day, the Schedule marks the affected task and shows an over-budget indicator in the day header. Hover over the indicator to see how many tasks are affected.

How Tasks Are Ordered

Tasks are ordered by start time. When two or more tasks share the same start time, the app orders them by type (scheduled tasks first, then regular tasks).

Blocked Time and Long-Running Tasks

Blocked periods (for example lunch breaks) can be added to the Schedule. When a task would run through a blocked period, it is shown as split: one segment up to the block, then a continued segment after it. That keeps the timeline readable and shows when work resumes.

Tasks that run past midnight are continued on the next day, so you see the full span of the work.

What You See

The Schedule shows a range of days (the upcoming 30 days). How many days are visible at once depends on the view mode and your screen size: the day view shows a single day, while the week and month views show fewer days on narrow screens and more on wide ones.

Planning Vs Scheduling

Planning (in the Planner view) assigns tasks to days without specific times. Scheduling (in the Schedule view) assigns both a date and a specific time:

  • When you schedule a task with time, it gets a due date and time
  • Scheduled tasks are removed from the Planner (they belong in the Schedule instead)
  • Tasks scheduled for today automatically appear in the Today View
  • You can reschedule tasks or move them to the backlog when needed