Click troubleshooting
Reconnecting forever
Section titled “Reconnecting forever”Confirm Host /healthz, the saved profile URL, and browser reachability. Click retries automatically, but it cannot start a stopped remote daemon. If the Host identity changed, create a new profile rather than reusing stale pairing material.
No usable workspace frame
Section titled “No usable workspace frame”Click accepts a valid empty workspace and renders its shell; it must not require a non-empty instances array. If boot remains initializing, preserve the diagnostics banner, runtime version, network errors, and workspace response for support.
Panels missing after reconnect
Section titled “Panels missing after reconnect”Check whether you switched Host or workspace. Definitions are Host/workspace scoped. Closing all instances should leave definitions in the library; it should not reopen them automatically on the next add.
Canvas covers native windows
Section titled “Canvas covers native windows”Native windows publish exact per-frame occlusion rectangles. Stale diagonal clipping or a Canvas hiding a native popup indicates overlay-coordinator drift. Capture the full viewport with the native window and panel boundaries visible.
Mobile scrolling drags a window
Section titled “Mobile scrolling drags a window”Management surfaces should be full-screen in mobile mode and content gestures should scroll with momentum. Confirm /mobile or a shortest viewport side under 700 CSS pixels, then reload after clearing an obsolete service worker if the old shell persists.