Keyboard navigation¶
Every action in Caffold works from the keyboard. If one doesn't, that's a bug. The keys below work whenever you are not typing in a field, and the key combinations work everywhere, even in the terminal. Selecting text and zooming the page are left to the browser, as on any other page.
Choose an action: F¶
Press F and short codes appear on the actions you can take in the current place: the workspace, or the dialog or popover that is open. Type a code to run its action. While you are typing, or in the terminal, use its key combination instead.
- Backspace removes the last letter you typed.
- Esc leaves without choosing.
Scroll an area: S¶
Press S to put codes on the areas that scroll, then type a code to choose one. In the chosen area:
| Keys | Scrolls |
|---|---|
| J / K | down or up a little |
| D / U | down or up by half the area |
| H / L | left or right |
Press S to choose another area, F to switch to actions, or Esc to stop scrolling.
Switch Tasks: T¶
On the Tasks screen, T opens the Task Switcher with codes already on its rows. It lists your pinned Tasks first and then the rest, each part with the most recently finished first, so the Task you just heard back from leads its part. Type a row's code, or choose a row, to open that Task. The Switch task button, the clock at the top of the Task list, opens the same list.
Leave a field: Esc¶
While you are typing a prompt, the keys go into the prompt. Press Esc to leave the prompt, and the keys work again. In the terminal, Esc goes to the program there; leave with ⌘+J or Ctrl+` instead.
Shortcut help: ?¶
? opens the list of keyboard shortcuts from anywhere, including in the middle of choosing an action or scrolling. Inside the list, F reaches its close button and S scrolls it. Press ? or Esc to close it.
Key combinations¶
These keys work while you are typing, in the terminal, and when keyboard navigation is off. Each action has two: the first line for keyboards with ⌘, the second for keyboards without it, such as on Windows, Linux, or Android.
| Keys | Does |
|---|---|
| ⌘+J Ctrl+` |
opens the terminal of a Task or Section, or goes back from it |
| ⌘+B Ctrl+Shift+B |
shows or hides the side panel, wherever the button in the top-left corner can |
| ⇧+⌘+F Ctrl+Shift+F |
puts codes on the actions, as F does |
Turn it off¶
Keys with Ctrl, Alt, or ⌘, and keys typed while an input method is composing, always go to the browser, except the key combinations. To give every single key back to the browser as well, turn off Keyboard navigation in Settings → Keyboard, which also lists all the shortcuts. The key combinations keep working, since they are the only way out of the terminal from the keyboard.