What to build
Make the keyboard shortcuts and shortcut help consistent across Day and Week. Users should not see different wording or conflicting expectations for shared shortcuts when they switch views.
This should consolidate the shortcut definitions and the visible shortcut lists so the app has one clear source for shared shortcuts, plus clearly documented view-specific shortcuts where the behavior intentionally differs.
Current investigation
Actual shortcut behavior is registered in these places:
- App-wide shortcuts are registered from the root shell:
d opens Day, w opens Week, Mod+K toggles the command palette, Escape closes the command palette, and Z handles login/logout.
- Day registers its view shortcuts in
useDayViewShortcuts: J/K move day-to-day, T goes to today or scrolls to now, [ toggles the sidebar, task shortcuts include U/C/E/Delete/Backspace/Enter/Mod+Z/Mod+Shift+Z, and calendar shortcuts include I/M.
- Week registers its view shortcuts in
useWeekShortcuts: J/K move week-to-week, T goes to the current week or scrolls to now, [ toggles the sidebar, A/C create all-day/timed events, I/M focus/edit a calendar event, arrow keys move shortcut-created drafts, and Shift+W / Shift+M create Someday events.
- J/K
move between tasks,Entercompletes the focused task,[toggles the shortcuts sidebar,Escapeexits back to Day,Treturns to Day/today,E Dedits the description,E Redits the reminder, andMod+Enter` saves the description.
Shortcut help is presented in separate paths:
- Day builds shortcut sections from
getShortcuts() and shows them inside the Planner Sidebar shortcut overlay.
- Week hand-builds its shortcut sections directly in
WeekView, then shows them inside the Planner Sidebar shortcut overlay.
- The Planner Sidebar footer uses
? / Shift+/ to open or close the shortcut overlay in Day and Week.
Known inconsistencies to fix:
[ is shown as “Close sidebar” in the shared Day shortcut data, but Week shows it as “Toggle sidebar,” and the actual behavior is generally toggle/open depending on state.
? is shown as “Show shortcuts” in the shared Day shortcut data, but Week shows it as “Toggle shortcuts.”
- Week’s visible shortcut list is hard-coded in
WeekView instead of using the shared shortcut data path that Day use.
- Day’s visible shortcut list does not show every active shortcut, such as Backspace delete and undo shortcuts.
- Some keys intentionally mean different things per view, such as
J/K for day navigation, week navigation, and task navigation, and C for task creation versus timed-event creation. The implementation should make the intentional differences clear while keeping shared/global shortcuts consistent.
Acceptance criteria
Blocked by
None - can start immediately.
What to build
Make the keyboard shortcuts and shortcut help consistent across Day and Week. Users should not see different wording or conflicting expectations for shared shortcuts when they switch views.
This should consolidate the shortcut definitions and the visible shortcut lists so the app has one clear source for shared shortcuts, plus clearly documented view-specific shortcuts where the behavior intentionally differs.
Current investigation
Actual shortcut behavior is registered in these places:
dopens Day,wopens Week,Mod+Ktoggles the command palette,Escapecloses the command palette, andZhandles login/logout.useDayViewShortcuts:J/Kmove day-to-day,Tgoes to today or scrolls to now,[toggles the sidebar, task shortcuts includeU/C/E/Delete/Backspace/Enter/Mod+Z/Mod+Shift+Z, and calendar shortcuts includeI/M.useWeekShortcuts:J/Kmove week-to-week,Tgoes to the current week or scrolls to now,[toggles the sidebar,A/Ccreate all-day/timed events,I/Mfocus/edit a calendar event, arrow keys move shortcut-created drafts, andShift+W/Shift+Mcreate Someday events.move between tasks,Entercompletes the focused task,[toggles the shortcuts sidebar,Escapeexits back to Day,Treturns to Day/today,E Dedits the description,E Redits the reminder, andMod+Enter` saves the description.Shortcut help is presented in separate paths:
getShortcuts()and shows them inside the Planner Sidebar shortcut overlay.WeekView, then shows them inside the Planner Sidebar shortcut overlay.?/Shift+/to open or close the shortcut overlay in Day and Week.Known inconsistencies to fix:
[is shown as “Close sidebar” in the shared Day shortcut data, but Week shows it as “Toggle sidebar,” and the actual behavior is generally toggle/open depending on state.?is shown as “Show shortcuts” in the shared Day shortcut data, but Week shows it as “Toggle shortcuts.”WeekViewinstead of using the shared shortcut data path that Day use.J/Kfor day navigation, week navigation, and task navigation, andCfor task creation versus timed-event creation. The implementation should make the intentional differences clear while keeping shared/global shortcuts consistent.Acceptance criteria
Blocked by
None - can start immediately.