← Commit history

Dock Bar guide: dashboards ship a settings-layout settings window and taskbar progress (indeterminate for open-ended AI work)

John Lauer ·32b0ff5d42 ·2mo ago ·parent 49bf7d7
1 file changed +3
docs/dockbar.md+3
@@ -187,6 +187,9 @@ The curated global list (`dock/apps.json` in adom/hydrogen-bootstrap) is a list 5. A favicon that actually exists at the declared path. 6. Test from Dock settings, Add app, `owner/slug`, on a machine that has never had your app installed. +7. A **settings window** built with the `settings-layout` skill: a cog in the upper right of the 44px header opens a dismissible modal (dimmed backdrop, never blurred), settings cards with a 3px accent edge and full-sentence descriptions, toggles rather than checkboxes, Install / Update / Uninstall rows with live consoles, and a two-click Restore defaults footer. Every dashboard shares this look so users only learn it once.+8. **Taskbar progress for long work.** Any verb that runs start to end paints a determinate progress bar on the app's Windows taskbar button, sized by the durations the app has measured for that operation (the `pup-taskbar-progress` skill is the reference; kicad, fusion and pup all ship it behind a toggle in their settings). Open-ended work driven by the AI, such as a part lookup that can take minutes, shows an **indeterminate** taskbar bar for as long as it runs, so the user always sees that something is happening without a false estimate.+ Reference implementation: adom/kicad-bridge, verified green end to end. The dock's own implementation notes live in the Hydrogen source at `docs/DOCK-BAR.md`.  ## Talk to the AI