diff --git a/docs/gotchas.md b/docs/gotchas.md index 13e28a4..fc873be 100644 --- a/docs/gotchas.md +++ b/docs/gotchas.md @@ -49,6 +49,13 @@ touching the adjacent code. treatment is lost and the icon renders black on dark menu bars. - `ApplicationMenu` is macOS-only in our usage; accelerators on Windows are single-character only. ContextMenu exists on macOS+Windows, not Linux. +- **Window-open flash prevention is three-layer** — remove any one and the + white/inverted blink returns: (1) windows are created `hidden: true` and + revealed by `showWhenReady` on the webview's first `dom-ready` (800 ms + fallback), (2) the bun preload bakes the persisted `data-theme`/tone/accent + attributes before first paint (`buildPreload`), (3) `ui/src/index.html` + carries an inline `