fix(desktop): show main window when ready-to-show never fires

.changeset/main-window-show-fallback.md

@@ -0,0 +1,5 @@
+---
+"@open-codesign/desktop": patch
+---
+
+Show the main window via a 2s fallback timer when `ready-to-show` never fires. On software-rendered systems (e.g. VMware/VirtualBox VMs where Chromium falls back to SwiftShader), the compositor never produces a first frame for a hidden window, so the window stayed invisible forever while the app ran healthy underneath.

apps/desktop/src/main/index.ts

@@ -103,7 +103,22 @@ function createWindow(): void {
     },
   });
 
-  mainWindow.on('ready-to-show', () => mainWindow?.show());
+  // On software-rendered systems (e.g. VMware SVGA → SwiftShader fallback)
+  // the compositor never produces a first frame for a hidden window, so
+  // ready-to-show never fires and the window stays invisible forever while
+  // the app runs healthy underneath. The fallback timer shows the window
+  // anyway; on healthy systems ready-to-show fires well within 2s and
+  // startup stays flicker-free.
+  const showFallback = setTimeout(() => {
+    if (mainWindow !== null && !mainWindow.isDestroyed() && !mainWindow.isVisible()) {
+      mainWindow.show();
+    }
+  }, 2000);
+  mainWindow.on('ready-to-show', () => {
+    clearTimeout(showFallback);
+    mainWindow?.show();
+  });
+  mainWindow.on('closed', () => clearTimeout(showFallback));
   // Null the reference on close so stale IPC sends from async emitters
   // (autoUpdater, long-running generate runs) become clean no-ops rather
   // than throwing "Object has been destroyed" on a discarded webContents.