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
changeset-release/main View source

Criteria completion

No incremental history — criteria tracking started on Apr 19.

Relationships

Implements 1
Related 3
Branches 3
changeset-release/main current done
main doneclaude/file-naming-convention-LJdwR doneclaude/align-sidenav-styling-4MuxV done
History 6
  1. f2b3512
    Content editedby Claude
    Add {ID}-{slug}.md filename convention + migrate filenames subcommand
  2. 59ded4a
    Content editedby Claude
    Implement SPEC-037 plan package hardening: all 7 work items
  3. f262d7b
    Content editedby Claude
    Backfill source attributes on all 123 work items
  4. b00edf7
    Content editedby Claude
    Add keyboard navigation to plan site sidebar
  5. 3d8d331
    Content editedby Claude
    Add WORK-050: converge plan renderer with shared layout engine
  6. 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)