← Commit history

dockbar guide: webview.favicon must be a white line icon, never the wrapped vendor's logo

John Lauer ·3991a4c837 ·1mo ago ·parent 35976f6
1 file changed +13
docs/dockbar.md+13
@@ -120,6 +120,19 @@ One file, `dockbar.json`, at the root of the app's wiki page repo. **This is the | `on_ready` | `"navigate_placeholder"` | Navigate the interstitial to the produced URL, or `"hand_to_ai"` to let a thread take the webview over | | `steps[]` | | `label`, `run`, optional `skip_if` (exit 0 skips), optional `await: "url"` + `url_pattern`, `timeout_seconds` (also governs the readiness wait on an awaiting step) | +### The favicon is a LINE ICON, not your vendor's logo++`webview.favicon` renders at 16px in ah's tab strip on a dark background, beside every other+dock app. It must be the app's own line-drawing SVG: `fill="none"`, `stroke="currentColor"`+or `#e6edf3`, `viewBox="0 0 24 24"`, stroke 1.5 to 2, transparent background, no plate+behind it. NOT the logo of the product you wrap (an orange Fusion badge or a blue KiCad tile+next to four white line icons is exactly the inconsistency the dashboard contract exists to+kill), not a filled silhouette, not a PNG, never emoji. If your app wraps a third-party tool,+draw the OBJECT your users work on instead: a board outline, an extrusion, a chip with a+download arrow. The `icons` sub-skill of `adom/adom-ui-design` is the full how-to, including+the pre-publish audit and the 16px look test. Use the same SVG for the dock card, the app+header mark and the wiki page, so your app is recognizable everywhere at a glance.+ ### health  | Field | Default | Meaning |