Sheets defines what users expect to do and which keys they use; the UI itself should feel native to a terminal: context-line bars, incremental search, key chips and fzf-style pickers over imitation GUI dialogs.
- commit
- f9df936e417d22c7e3f5cd90d50c25927521987f
- parent
- 825d7ad7308087f806bc403a345d703507ad6160
- author
- Dami <dami.etoile@gmail.com>
| M | docs/ | 18 | ++++++++++++++---- |
@@ -13,18 +13,28 @@ follow-up task.
1313 1-2-3 disagree, Sheets wins. 1-2-3 lives on as the visual identity:1414 the control panel doubling as the formula bar, the mode indicator, the1515 crisp character grid.16-2. **Everything is discoverable.** Every action is a registered command16+2. **Familiar, but native to the terminal.** Sheets tells us which jobs17+ users expect to get done and which keys they reach for, not what the18+ screen must look like. This is a Bubble Tea program: prefer patterns19+ that feel at home in a terminal when they serve the same need as well20+ or better. Bars and prompts on the context line or status line over21+ floating dialogs, incremental search that highlights as you type,22+ toggles shown as key chips, pickers in the style of fzf or lazygit, and23+ no fake GUI chrome (drop shadows, faux buttons) unless it earns its24+ place. Overlays are fine when content genuinely needs room (menus,25+ long lists), and they stay keyboard-first.26+3. **Everything is discoverable.** Every action is a registered command1727 (`internal/ui/commands.go`) with a title and one-line description. It is1828 reachable from the menu where Sheets would put it, from key bindings in1929 `keymap`, and from help (generated from the registry). When the command2030 palette lands, it lists every registered command with its keys.21-3. **The screen always says what's going on.** The mode indicator is always31+4. **The screen always says what's going on.** The mode indicator is always2232 correct. The third panel line tells the user what keys do in any2333 non-READY state. Prompts live on the second panel line.24-4. **Never lose work.** Destructive actions warn when there are unsaved34+5. **Never lose work.** Destructive actions warn when there are unsaved2535 changes and are undoable once undo exists. Errors are specific2636 ("expected , or )" with the cursor on the spot), never generic.27-5. **Esc backs out one level; Enter confirms.** Everywhere, no exceptions.37+6. **Esc backs out one level; Enter confirms.** Everywhere, no exceptions.2838 2939 ## Visual rules3040