# Keyboard Shortcuts

Navigate Simpl faster with keyboard shortcuts designed for power users.

## Overview

Simpl includes keyboard shortcuts for common actions, allowing you to browse and navigate without using the mouse.

## Accessing the Shortcuts Reference

Press `?` at any time to open the keyboard shortcuts dialog, which shows all available shortcuts.

## Navigation Shortcuts

### List View Navigation

| Shortcut | Action |
| --- | --- |
| `j` | Move to next record |
| `k` | Move to previous record |
| `↓` | Move to next record |
| `↑` | Move to previous record |
| `Enter` | Open selected record detail |
| `o` | Open selected record detail |

### Record Selection

As you navigate with `j`/`k`, the currently selected record is highlighted. Press `Enter` to open it.

### Detail View Navigation

| Shortcut | Action |
| --- | --- |
| `Escape` | Close detail view |
| `j` | Next record (while in detail) |
| `k` | Previous record (while in detail) |

## Search and Filter Shortcuts

| Shortcut | Action |
| --- | --- |
| `/` | Focus search input |
| `Escape` | Clear search / close panels |

### Quick Search Workflow

1. Press `/` to focus search
2. Type your query
3. Press `Escape` to clear and return to list
4. Or press `↓` to navigate results

## Panel Shortcuts

| Shortcut | Action |
| --- | --- |
| `?` | Open shortcuts help |
| `Escape` | Close any open panel/modal |

## Vim-Style Navigation

Simpl uses vim-inspired navigation keys:

- `j` \- Down (next)
- `k` \- Up (previous)

This allows efficient one-handed navigation familiar to vim users.

## Tips for Efficient Navigation

### Browse Without Mouse

1. Use `j`/`k` to scan through records
2. Press `Enter` to open interesting records
3. Press `Escape` to close and continue
4. Use `/` to search when you know what you want

### Quick Record Review

For reviewing multiple records:

1. Open detail view with `Enter`
2. Press `j` to advance to next record
3. Review continues without closing modal
4. Press `Escape` when done

### Search Workflow

1. Press `/` to start searching
2. Type your query
3. Results filter automatically
4. Use `j`/`k` to navigate results
5. `Enter` to open a result

## Keyboard Accessibility

### Focus Management

Simpl maintains logical focus order:

- Tab through interactive elements
- Enter activates focused elements
- Escape closes modals and panels

### Screen Reader Support

Keyboard navigation works with screen readers:

- Proper ARIA labels
- Focus announcements
- Semantic structure

## Customization

Currently, keyboard shortcuts are not customizable. The defaults are designed to be intuitive and conflict-free with browser shortcuts.

## Shortcut Quick Reference

### Essential Shortcuts

| Shortcut | Action |
| --- | --- |
| `?` | Show all shortcuts |
| `j` / `↓` | Next record |
| `k` / `↑` | Previous record |
| `Enter` | Open record |
| `Escape` | Close / go back |
| `/` | Search |

### When in Detail View

| Shortcut | Action |
| --- | --- |
| `j` | Next record |
| `k` | Previous record |
| `Escape` | Close detail view |

## Best Practices

### Learn the Core Three

Start with these essential shortcuts:

1. `j`/`k` \- Navigate up/down
2. `Enter` \- Open/select
3. `Escape` \- Close/cancel

Once comfortable, add:

4. `/` \- Quick search
5. `?` \- Reference other shortcuts

### Combine with Mouse

Keyboard shortcuts complement mouse usage:

- Use mouse for complex selection
- Use keyboard for rapid navigation
- Switch based on your workflow

### Practice Makes Perfect

Keyboard navigation becomes faster with practice:

- Force yourself to use shortcuts
- Avoid reaching for the mouse
- Speed improves over time

## Next Steps

- [Export your data](/content/docs/features/export/index.html) for external analysis
- [Learn about security](/content/docs/security/index.html) and data protection
- Return to the [documentation hub](/content/docs/index.html)