# Keyboard Shortcuts

iKanban is designed to be used efficiently without a mouse. Here's a complete reference of all keyboard shortcuts.

## Global Shortcuts

These shortcuts work anywhere in the application.

| Shortcut | Action |
|----------|--------|
| `Cmd+K` / `Ctrl+K` | Open command palette / search |
| `Cmd+N` / `Ctrl+N` | Create new task |
| `Cmd+,` / `Ctrl+,` | Open settings |
| `Cmd+/` / `Ctrl+/` | Toggle sidebar |
| `?` | Show keyboard shortcuts help |
| `Escape` | Close dialog, panel, or modal |

## Navigation Shortcuts

Use `G` followed by a letter to navigate between sections.

| Shortcut | Destination |
|----------|------------|
| `G then P` | Go to Projects |
| `G then T` | Go to Triage (Inbox) |
| `G then M` | Go to My Issues |
| `G then A` | Go to Activity feed |
| `G then S` | Go to Settings |

## Task List Shortcuts

When focus is on a task list or kanban board:

| Shortcut | Action |
|----------|--------|
| `↑` / `K` | Select previous task |
| `↓` / `J` | Select next task |
| `Enter` | Open selected task |
| `C` | Create new task (quick create) |
| `F` | Open filter panel |
| `X` | Toggle multi-select on focused task |
| `/` | Focus search/filter input |

## Task Detail Shortcuts

When a task is open in the detail panel:

| Shortcut | Action |
|----------|--------|
| `Escape` | Close task panel |
| `E` | Edit task title |
| `A` | Assign to someone |
| `P` | Change priority |
| `S` | Change status |
| `L` | Add or change label |
| `Cmd+Enter` / `Ctrl+Enter` | Submit comment |
| `[` | Previous task in list |
| `]` | Next task in list |

## Status Quick-Change

When a task is selected or open, change its status quickly:

| Shortcut | Status |
|----------|--------|
| `1` | Set status to Todo |
| `2` | Set status to In Progress |
| `3` | Set status to In Review |
| `4` | Set status to Done |

## Priority Quick-Change

| Shortcut | Priority |
|----------|---------|
| `Shift+1` | Urgent |
| `Shift+2` | High |
| `Shift+3` | Medium |
| `Shift+4` | Low |

## Editor Shortcuts

When writing in the description or comment editor:

| Shortcut | Format |
|----------|--------|
| `Cmd+B` / `Ctrl+B` | **Bold** |
| `Cmd+I` / `Ctrl+I` | *Italic* |
| `Cmd+K` / `Ctrl+K` | Insert link |
| `Cmd+Shift+C` / `Ctrl+Shift+C` | Inline code |
| `Cmd+Enter` / `Ctrl+Enter` | Submit / save |
| `Escape` | Cancel editing |

Markdown syntax also works directly:
- `**text**` → **bold**
- `*text*` → *italic*
- `` `code` `` → `code`
- `- item` → bullet list
- `1. item` → numbered list
- `> quote` → blockquote
- `# Heading` → heading
- `---` → horizontal rule

## Document Editor Shortcuts

When editing a document:

| Shortcut | Action |
|----------|--------|
| `Cmd+S` / `Ctrl+S` | Save document |
| `Cmd+Z` / `Ctrl+Z` | Undo |
| `Cmd+Shift+Z` / `Ctrl+Shift+Z` | Redo |
| `Cmd+F` / `Ctrl+F` | Find in document |
| `Cmd+A` / `Ctrl+A` | Select all |

## Search Shortcuts

When the command palette (`Cmd+K`) is open:

| Shortcut | Action |
|----------|--------|
| `↑` / `↓` | Navigate results |
| `Enter` | Open selected result |
| `Escape` | Close search |
| `@` prefix | Filter by assignee |
| `#` prefix | Filter by label |
| `!` prefix | Filter by priority |

## Kanban Board Shortcuts

| Shortcut | Action |
|----------|--------|
| `←` / `→` | Move focused task to previous/next column |
| `Space` | Expand/collapse a column |

## Multi-Select Shortcuts

In list view with checkboxes:

| Shortcut | Action |
|----------|--------|
| `Cmd+A` / `Ctrl+A` | Select all tasks |
| `Escape` | Deselect all |
| `Click + Shift+Click` | Select a range |

## Tips for Power Users

- Combine navigation shortcuts: `G then P` → `↓↓↓` → `Enter` to quickly jump to the third project
- Use `[` and `]` to quickly review multiple tasks without going back to the list
- The command palette (`Cmd+K`) supports typing task identifiers directly (e.g., `ENG-42`) to jump to that task
- Press `?` at any time to see a context-aware shortcut overlay

## Customizing Shortcuts

Currently, keyboard shortcuts are not customizable. Support for custom key bindings is planned for a future release.