From 962b669cac946286428deb1e8d944a1f7ee311b1 Mon Sep 17 00:00:00 2001
From: Jannis Braun <151788261+TheZwiss@users.noreply.github.com>
Date: Mon, 27 Apr 2026 12:54:42 +0200
Subject: [PATCH] docs(desktop): clarify cross-platform hidden-launch detection

---
 packages/desktop/src/main.ts | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/packages/desktop/src/main.ts b/packages/desktop/src/main.ts
index 5909b145..8c29fc6c 100644
--- a/packages/desktop/src/main.ts
+++ b/packages/desktop/src/main.ts
@@ -323,7 +323,10 @@ function createWindow(): void {
   }
 
   mainWindow.once('ready-to-show', () => {
-    // Check if launched minimized (auto-start to tray)
+    // Hidden-launch detection. We pass `args: ['--hidden']` on all three platforms
+    // (see applyLoginItemSettings), so the argv check is the primary signal. On
+    // macOS we also honour `wasOpenedAsHidden` as a fallback for the legacy
+    // openAsHidden path on macOS < 13.
     const launchedHidden =
       process.argv.includes('--hidden') ||
       (process.platform === 'darwin' && app.getLoginItemSettings().wasOpenedAsHidden);