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:simple
claude/align-sidenav-styling-4MuxV View source

Criteria completion

No incremental history — criteria tracking started on Apr 17.

Relationships

Implements 1
Related 3
Branches 3
claude/align-sidenav-styling-4MuxV current done
main doneclaude/file-naming-convention-LJdwR donechangeset-release/main done
History 3
  1. b00edf7
    Content editedby Claude
    Add keyboard navigation to plan site sidebar
  2. 3d8d331
    Content editedby Claude
    Add WORK-050: converge plan renderer with shared layout engine
  3. f5b8bf8
    Created (done)by Claude
    Add work items WORK-037 through WORK-049 for plan site specs

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)