Files
vibe-kanban/docs/configuration-customisation/keyboard-shortcuts.mdx
Louis Knight-Webb fef06cf00e Done! I've successfully removed arrow key navigation while preserving hjkl shortcuts. Here's what changed: (#946)
## Changes Made:

1. **[frontend/src/keyboard/registry.ts](file:///private/var/folders/m1/9q_ct1913z10v6wbnv54j25r0000gn/T/vibe-kanban/worktrees/155e-remove-keyboard/frontend/src/keyboard/registry.ts)**
   - Removed arrow keys from navigation bindings, kept only hjkl
   - Fixed Enter key conflict by changing fullscreen toggle to ⌘/Ctrl+Enter

2. **[docs/configuration-customisation/keyboard-shortcuts.mdx](file:///private/var/folders/m1/9q_ct1913z10v6wbnv54j25r0000gn/T/vibe-kanban/worktrees/155e-remove-keyboard/docs/configuration-customisation/keyboard-shortcuts.mdx)**
   - Updated Board Navigation section to show hjkl only
   - Added fullscreen toggle documentation

All type checks pass ✓
2025-10-06 10:51:26 +01:00

60 lines
2.5 KiB
Plaintext

---
title: "Keyboard Shortcuts"
description: "Complete guide to keyboard shortcuts for efficient navigation and interaction in Vibe Kanban"
---
Vibe Kanban provides comprehensive keyboard shortcuts to help you navigate and interact with the application efficiently. These shortcuts are organised by scope and context.
## Platform Keys
- **⌘** = Mac Command key
- **Ctrl** = Windows/Linux Control key
## Global Shortcuts
These shortcuts work anywhere in the application (unless you're typing in an input field):
| Shortcut | Action | Description |
|----------|--------|-------------|
| `C` | Create Task | Opens the Task Form dialog to create a new task |
| `⌘/Ctrl + S` | Focus Search | Puts keyboard focus into the global search input |
## Board Navigation
These shortcuts work when a task card is highlighted with the blue focus ring:
| Shortcut | Action | Description |
|----------|--------|-------------|
| `k` / `j` | Vertical Navigation | Move focus up/down within the current column |
| `h` / `l` | Horizontal Navigation | Move focus to first task in previous/next non-empty column |
| `Enter` | Open Task | Open the Task Details panel for the focused task |
| `d` | Delete Task | Delete the currently focused task |
## Form Submission
These shortcuts work in various forms and dialogs:
| Shortcut | Action | Context |
|----------|--------|---------|
| `⌘/Ctrl + Enter` | Submit | Create & Start (Task Form), Save (Template Editor) |
| `⌘/Ctrl + Enter` | Send | Send follow-up message in Task Details |
| `⌘/Ctrl + Enter` | Save Comment | Add or save comment in Diff Review |
| `⌘/Ctrl + Enter` | Toggle Fullscreen | Toggle fullscreen view in Task Details |
| `Escape` | Cancel/Clear | Clear draft in follow-up, cancel comment editing |
## Search
| Shortcut | Action | Description |
|----------|--------|-------------|
| `⌘/Ctrl + S` | Focus Search | Move cursor to the search input field |
| `Escape` | Clear Search | Clear search text and remove focus (when in search field) |
*Note: The search field displays a "⌘S" badge to help you discover this shortcut.*
## Tips
- **Focus Indicators**: Look for blue focus rings around task cards to know when board navigation shortcuts are active
- **Input Fields**: Global shortcuts are disabled when typing in text fields to avoid conflicts
- **Visual Cues**: Some shortcuts display badges or hints in the interface (like the "⌘S" next to search)
- **Modifier Keys**: Global shortcuts are disabled when holding Ctrl/⌘/Alt unless the shortcut specifically uses those modifiers