WORK-048
ID:WORK-048Status:done

Keyboard navigation for plan site

Add keyboard shortcuts for fast navigation: / to focus search, j/k to move between sidebar items, Enter to navigate, [/] to jump between entity type groups, o to toggle collapse, Escape to clear.

Priority:lowComplexity:simpleSource:SPEC-015
claude/file-naming-convention-LJdwR View source

Criteria completion

No incremental history — criteria tracking started on Apr 21.

Relationships

Implements 1
Related 3
Branches 3
claude/file-naming-convention-LJdwR current done
main donechangeset-release/main doneclaude/align-sidenav-styling-4MuxV done
History 2
  1. bbbb94c
    Created (done)by bjornolofandersson
  2. f2b3512
    Content editedby Claude
    Add {ID}-{slug}.md filename convention + migrate filenames subcommand

Acceptance Criteria

  • / focuses the search/filter bar
  • Escape clears filter and unfocuses search bar
  • j/k moves to next/previous item in sidebar
  • Enter navigates to the focused item
  • [/] jumps to previous/next entity type group
  • o toggles collapse of the focused group
  • Visual focus indicator matches the active link style
  • Shortcuts don't fire when typing in the search input (except Escape)

Approach

A keyboard-nav behavior. Sidebar items get tabindex attributes. The behavior manages a virtual focus cursor and delegates to existing collapse/filter behaviors.

Once WORK-050 converges the plan renderer with the shared layout engine, this behavior can be registered in the planLayout.behaviors array (like mobile-menu and search in docsLayout), removing the need for inline script injection.

References

  • SPEC-015 (Plan Site UX at Scale — Feature 5)
  • WORK-044 (collapsible groups — o key integration)
  • WORK-045 (search bar — / key integration)
  • WORK-050 (renderer convergence — enables behaviors array registration)