Bug Description
Power users and developers expect keyboard-driven navigation in modern documentation sites. Currently, finding content requires scrolling through the sidebar or using basic search. A Command Palette (activated by Cmd+K or Ctrl+K) would allow instant jumping to any page, section, or recent search — dramatically improving navigation efficiency.
Competitor Benchmark
- Vercel:
Cmd+K opens palette with page search, command execution
- Stripe:
Cmd+K for quick navigation to any doc section
- Linear:
Cmd+K for command palette across entire app
- Notion:
Cmd+K for universal search and navigation
- Tailwind CSS:
Cmd+K for instant doc search
Affected Users
- Power users who navigate docs frequently
- Developers who prefer keyboard over mouse
- Accessibility users relying on keyboard navigation
- Mobile users (can use tap gesture)
Blast Radius
- Primary: All returning visitors
- Secondary: Users on large screens where sidebar is overwhelming
- Impact: Faster navigation, reduced cognitive load, modern UX expectation
Root Cause Analysis
No keyboard shortcut system is implemented. The existing search requires clicking the search box first. Command palette is a UX pattern now standard across developer tools.
Proposed Solution
Option A: Algolia DocSearch with Cmd+K (Recommended)
If Algolia DocSearch is implemented, it naturally supports Cmd+K activation:
document.addEventListener('keydown', (e) => {
if ((e.metaKey || e.ctrlKey) && e.key === 'k') {
e.preventDefault();
docsearch.open();
}
});
Option B: Custom Command Palette Component
Build lightweight palette using:
- Fuse.js for fuzzy search
- Page title + heading index
- Recent pages history
- Keyboard navigation (arrow keys, enter, escape)
Additional Fixes Required
Acceptance Criteria
Raw Context
Developers navigating between RPC docs, smart contract guides, and node setup repeatedly waste time scrolling. Command palette is now table stakes for developer documentation.
Bug Description
Power users and developers expect keyboard-driven navigation in modern documentation sites. Currently, finding content requires scrolling through the sidebar or using basic search. A Command Palette (activated by Cmd+K or Ctrl+K) would allow instant jumping to any page, section, or recent search — dramatically improving navigation efficiency.
Competitor Benchmark
Cmd+Kopens palette with page search, command executionCmd+Kfor quick navigation to any doc sectionCmd+Kfor command palette across entire appCmd+Kfor universal search and navigationCmd+Kfor instant doc searchAffected Users
Blast Radius
Root Cause Analysis
No keyboard shortcut system is implemented. The existing search requires clicking the search box first. Command palette is a UX pattern now standard across developer tools.
Proposed Solution
Option A: Algolia DocSearch with Cmd+K (Recommended)
If Algolia DocSearch is implemented, it naturally supports
Cmd+Kactivation:Option B: Custom Command Palette Component
Build lightweight palette using:
Additional Fixes Required
Acceptance Criteria
Cmd+K(Mac) /Ctrl+K(Windows/Linux) opens paletteEscapecloses paletteEnterselects highlighted resultRaw Context
Developers navigating between RPC docs, smart contract guides, and node setup repeatedly waste time scrolling. Command palette is now table stakes for developer documentation.