feat: keyboard-first navigation & shortcuts

[siribeesu]

Summary

StudyPlan is heavily used for planning and task management. Many students work with keyboards (laptops, desktops) and expect quick keyboard navigation (arrow keys, shortcuts) similar to other productivity tools. Right now, task interactions appear to be mostly mouse / touch driven, with no clearly documented keyboard shortcuts or “keyboard-first” navigation.

Problem

• Moving between tasks, starting Focus Sessions, and switching views likely requires multiple mouse clicks.
• Power users (keyboard-centric) cannot quickly navigate tasks, start sessions, or archive/complete items using keys.
• Accessibility is also weaker if keyboard navigation is limited to basic tab focus only.

Proposed Improvement

Introduce keyboard-first navigation and shortcuts across major views:

Baseline navigation:

• Arrow keys (↑/↓/←/→) move focus between tasks in planner lists/boards.
• Enter/Space toggles selection or opens task details editor.
• Esc closes dialogs or exits selection mode.

View-level shortcuts (examples, adjustable):

• P to jump to Planner view.
• C to jump to Calendar.
• F to open Focus Sessions.
• N to add a new task.

Task actions:

• Ctrl+Enter or Cmd+Enter to mark current focused task as completed.
• Del to delete current focused task (with confirmation).
• A to archive current focused task.

Focus Sessions:

• Keyboard shortcut to start a Focus Session from selected tasks.
• Space or Enter to start/pause session timer if applicable.
• Esc to end/cancel the session.

Why This Is Needed

• Keyboard shortcuts significantly speed up workflow for students who plan large numbers of tasks.
• It improves accessibility by making all core actions usable without a mouse.
• It aligns StudyPlan with other productivity apps that emphasize efficient keyboard-driven usage.

Expected Result

• Users can navigate tasks, views, and Focus Sessions using the keyboard only.
• Common actions (complete, archive, delete, start session) are available through documented shortcuts.
• The app feels more responsive and “pro” for heavy daily use.

Implementation Sketch

Frontend:

• Introduce a central keyboard handler that:
  • Checks current view / mode.
  • Dispatches actions based on key combinations.
• Ensure focus management is consistent: one “current task” or “current element” per view.
• Display a small “keyboard shortcuts” help dialog (e.g., ? or a button).

Accessibility:

• Respect existing focus indicators and ARIA semantics.
• Avoid conflicting with browser-native shortcuts.

Tests:

• Verify navigation between tasks uses arrow keys as expected.
• Verify shortcuts trigger the correct actions in planner, calendar, and Focus Sessions.
• Verify that keyboard shortcuts do not break existing mouse/touch workflows.

Additional Context

This enhancement focuses on interaction efficiency and accessibility, not on layout density (already covered by compact/expanded view) or bulk actions (covered by another enhancement). It makes StudyPlan friendlier for keyboard-centric students and power users.

[cyber-scribe]

/claim