docs/adr/0002-one-dashboard-fixed-keybinds.md

Rama main · réplica de lectura del repositorio original.

---
status: superseded by ADR 0004
---

# One Dashboard, a fixed set of keybinds; everything else is a command

The first TUI copied a developer tool's shape — five screens, a tasks overlay, about thirty keybinds — and it was too much: people could not tell what mattered. The TUI is now one Dashboard with persistent panels (Apps with their Status, Needs action, App details in tabs) and a fixed keybind budget: select (↑/↓), tabs (tab), start/stop (enter), open (o), copy the Admin password (c), update (u), retry Setup (r), install (i), backup (b), help (?), quit (q), plus pgup/pgdn to scroll the details tab. A new key is added only for an Action people trigger often and only by replacing or justifying against this list; destructive or rare operations (remove, purge, restore, config, credentials listing) stay commands. We chose fewest features that work over coverage, accepting that power users reach for the CLI.

Amendment: re-confirming Host settings (Exposure, LAN IP, time zone) earned no key. It is the first entry of the install picker (`i`), using the picker's own space/enter/esc, and `self-host config review` on the command line.

Second amendment: the picker and the Host settings overlay were too small for the work people do there, so they became full-screen views. The Dashboard is home; Install (`i`), Settings (`s`) and Stack (`d`) are full-screen surfaces for tasks that need space, each one key away, with a shared top bar, their own footer hints, scrolling, and `esc` back to the Dashboard. A focused text field consumes `esc` first. `/` searches the catalog in Install, `ctrl+s` applies pending Settings changes, and `u`/`r` work the Stack. Destructive or rare operations (remove, purge, restore) stay commands.

Third amendment: Workflow (`w`) is a full-screen view for the frequent need to see every App's remembered Setup steps, Links and check, with their states and counts, selection via ↑/↓ or k/j, space to collapse or expand an App (set-up Apps start collapsed, the rest expanded), `/` to filter Apps by name or id, pgup/pgdn and the mouse wheel to scroll, and `esc` to clear the filter then return to the Dashboard.

Within Workflow, `enter` expands or collapses a failed step's error and hint; `r` retries the selected App's Setup.

Fourth amendment: `c` opens a credential picker for the Admin password, the
selected App's Admin login alias when it has one, and the selected App's saved
API keys. It shows names, then fetches the chosen value only for copying. Stack
(`d`) also owns Project-wide controls: `1` Up, `2` Down,
`3` Restart all, plus enter to start/stop the selected App. These keys stay in
Stack because operating the whole Compose Project is distinct from operating
one App on the Dashboard. Down removes only that Project's containers and
networks; it keeps volumes, App files and remembered Setup. Before Down runs it
asks first, naming what goes away (the Project's containers and networks) and
what stays (volumes, App files, Setup): `y` confirms, any other key cancels.