# Keyboard Reference

The floating Keyboard Reference is a live map of your current layout — the fastest way to learn and switch layouts.

## Use it

![Keyboard Reference](images/keyboard-reference.png)

1. Press <kbd>K</kbd> (right-handed) or <kbd>D</kbd> (left-handed), or use the Control Strip / popup / New Tab toggle.
2. Hover a keycap to see the bound action.
3. Use the **titlebar layout dropdown** to:
   - Switch built-in families or custom layouts
   - Open Layout Editor (Edit / New / Duplicate)
   - Launch **Onboarding Tutorial**
   - Open **KeyPilot Documentation/Help** (this popover)
   - Open **KeyPilot Settings**
4. Drag the window; collapse it when you need screen space; close with the × or the same toggle key.
5. While KeyPilot is in Text Mode, use <kbd>Exit</kbd> on the reference chrome if you prefer not to press <kbd>Esc</kbd>.

## Reference

### What it shows

- Active family, handedness, and custom assignments
- Always-on system keys
- Optional number row (Settings → Keyboard)
- Pressed-key highlight when feedback is enabled
- Optional glow on action keys when you hover a link (Settings → Click Mode)

### Edit mode

When <kbd>Alt</kbd>+<kbd>C</kbd> Layout Editor is open, the Keyboard Reference becomes the placement surface: pick an action in the library, then click a keycap to assign it.

### Tips

- Leave it open on a second monitor or corner while learning.
- If a key does nothing, check this window before assuming KeyPilot is broken — you may be on Navigation family or a sparse custom layout.
