Skip to content

feat(ui): keyboard shortcut cheat sheet overlay#63

Open
advancedresearcharray wants to merge 8 commits into
mainfrom
feat/issue-428-keyboard-shortcut-cheat-sheet-hands-on
Open

feat(ui): keyboard shortcut cheat sheet overlay#63
advancedresearcharray wants to merge 8 commits into
mainfrom
feat/issue-428-keyboard-shortcut-cheat-sheet-hands-on

Conversation

@advancedresearcharray

Copy link
Copy Markdown
Owner

Summary

  • Replace the static shortcuts dialog with a searchable CommandDialog cheat sheet driven by live keybindings from useKeybindings / GET /api/kiwi/keybindings
  • Open via bare ? (outside inputs/editors) or Cmd+/ (shortcuts_help) globally; dismiss with Esc or click-outside
  • Group shortcuts by Navigation / Views / Editor with platform-aware <kbd> labels (⌘ vs Ctrl) and a HelpCircle toolbar button for mouse users
  • Block other global shortcuts while the overlay is open; guard tree/canvas local handlers

Test plan

  • cd ui && npm test -- --run src/lib/keyboardShortcutsOverlay.test.ts src/lib/kiwiKeybindings.test.ts src/lib/overlayDismiss.test.ts — 60 tests pass
  • cd ui && npm test -- --run — 236 tests pass (full UI suite)
  • Press ? on welcome screen → overlay opens with grouped shortcuts
  • Press ? while focused in editor → overlay does not open
  • Press Cmd+/ while editing → overlay opens
  • Type in filter box → list filters
  • Click HelpCircle in toolbar → overlay toggles
  • Esc dismisses overlay

Closes kiwifs#428

Made with Cursor

amelia751 and others added 5 commits June 30, 2026 22:17
…iwifs#460)

- Add headless `content` prop to KiwiPage for server-free markdown rendering
- Add data-driven `data` prop to KiwiTree for static tree rendering
- Create KiwiProvider context (connected/static/custom fetching modes + theme)
- Extract remark/rehype plugin chain as standalone kiwiMarkdown exports
- Add event callbacks: onWikiLinkClick, onHeadingVisible, onRename, onDelete
- Configure Vite library build (vite.lib.config.ts) and tsconfig.lib.json
- Update package.json: @kiwifs/ui, peerDependencies on React 19, npm exports

Published as @kiwifs/ui@0.1.0 on npm.

Co-authored-by: Lam Dao Que Anh <anhlam@Lams-MacBook-Air-9.local>
Co-authored-by: Cursor <cursoragent@cursor.com>
Add searchable CommandDialog overlay for keyboard shortcuts, triggered
by ? (outside inputs) or mod+/. Includes platform-aware kbd labels,
live bindings from useKeybindings, HelpCircle toolbar button, and
regression tests for overlay toggle and global shortcut suppression.

Closes kiwifs#428

Signed-off-by: Array Fleet <fleet@advancedresearcharray.local>
…livery

Co-authored-by: Cursor <cursoragent@cursor.com>
Record full UI Vitest pass (236 tests) on feat/issue-428-keyboard-shortcut-cheat-sheet-v2.

Co-authored-by: Cursor <cursoragent@cursor.com>
…verlay

Re-verified feature branch, regression tests, and full UI suite before
pushing PR closing kiwifs#428.

Co-authored-by: Cursor <cursoragent@cursor.com>
@advancedresearcharray advancedresearcharray force-pushed the feat/issue-428-keyboard-shortcut-cheat-sheet-hands-on branch from c0d976e to 57fa720 Compare July 3, 2026 02:14
Array Fleet and others added 3 commits July 3, 2026 02:18
… overlay

Log test results and Kiwi MCP unavailability after hands-on re-verification
of the keyboard shortcut cheat sheet implementation on v2 branch.

Co-authored-by: Cursor <cursoragent@cursor.com>
Confirm green UI regression tests after restoring corrupted mkdocs.go;
record delivery state for keyboard shortcut cheat sheet overlay PR.

Co-authored-by: Cursor <cursoragent@cursor.com>
Close search/new dialogs when opening the keyboard cheat sheet and
sync the overlay module flag synchronously so tree/canvas handlers
suppress keys immediately. Adds regression tests for toggle state.

Closes kiwifs#428

Co-authored-by: Cursor <cursoragent@cursor.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat(ui): keyboard shortcut cheat sheet overlay

2 participants