feat: add tray icon

apps/desktop/package.json

@@ -16,7 +16,8 @@
   "dependencies": {
     "effect": "catalog:",
     "electron": "40.6.0",
-    "electron-updater": "^6.6.2"
+    "electron-updater": "^6.6.2",
+    "sharp": "^0.34.5"
   },
   "devDependencies": {
     "@t3tools/contracts": "workspace:*",

apps/desktop/src/main.ts

@@ -43,6 +43,7 @@ import {
   reduceDesktopUpdateStateOnUpdateAvailable,
 } from "./updateMachine";
 import { isArm64HostRunningIntelBuild, resolveDesktopRuntimeInfo } from "./runtimeArch";
+import { setupTrayIpcHandlers, setTrayEnabled, setReadyToHandleTrayMessages } from "./tray";
 
 fixPath();
 
@@ -1330,13 +1331,16 @@ async function bootstrap(): Promise<void> {
   writeDesktopLogHeader("bootstrap backend start requested");
   mainWindow = createWindow();
   writeDesktopLogHeader("bootstrap main window created");
+  setupTrayIpcHandlers();
+  writeDesktopLogHeader("bootstrap tray ipc handlers registered");
 }
 
 app.on("before-quit", () => {
   isQuitting = true;
   writeDesktopLogHeader("before-quit received");
   clearUpdatePollTimer();
   stopBackend();
+  setTrayEnabled(false);
   restoreStdIoCapture?.();
 });
 
@@ -1366,6 +1370,7 @@ app.on("window-all-closed", () => {
   if (process.platform !== "darwin") {
     app.quit();
   }
+  setReadyToHandleTrayMessages(false);
 });
 
 if (process.platform !== "win32") {
@@ -1389,3 +1394,10 @@ if (process.platform !== "win32") {
     app.quit();
   });
 }
+
+export function getMainWindow(createIfNeeded: boolean = false): BrowserWindow | null {
+  if (createIfNeeded && mainWindow === null) {
+    mainWindow = createWindow();
+  }
+  return mainWindow;
+}

apps/desktop/src/preload.ts

@@ -1,5 +1,5 @@
 import { contextBridge, ipcRenderer } from "electron";
-import type { DesktopBridge } from "@t3tools/contracts";
+import type { DesktopBridge, DesktopTrayState } from "@t3tools/contracts";
 
 const PICK_FOLDER_CHANNEL = "desktop:pick-folder";
 const CONFIRM_CHANNEL = "desktop:confirm";
@@ -11,6 +11,11 @@ const UPDATE_STATE_CHANNEL = "desktop:update-state";
 const UPDATE_GET_STATE_CHANNEL = "desktop:update-get-state";
 const UPDATE_DOWNLOAD_CHANNEL = "desktop:update-download";
 const UPDATE_INSTALL_CHANNEL = "desktop:update-install";
+const SET_TRAY_ENABLED_CHANNEL = "desktop:set-tray-enabled";
+const GET_TRAY_STATE_CHANNEL = "desktop:get-tray-state";
+const SET_TRAY_STATE_CHANNEL = "desktop:set-tray-state";
+const SET_READY_TO_HANDLE_TRAY_MESSAGES_CHANNEL = "desktop:set-ready-to-handle-tray-messages";
+const TRAY_MESSAGE_CHANNEL = "desktop:tray-message";
 const wsUrl = process.env.T3CODE_DESKTOP_WS_URL ?? null;
 
 contextBridge.exposeInMainWorld("desktopBridge", {
@@ -45,4 +50,20 @@ contextBridge.exposeInMainWorld("desktopBridge", {
       ipcRenderer.removeListener(UPDATE_STATE_CHANNEL, wrappedListener);
     };
   },
+  setTrayEnabled: (enabled: boolean) => ipcRenderer.invoke(SET_TRAY_ENABLED_CHANNEL, enabled),
+  getTrayState: () => ipcRenderer.invoke(GET_TRAY_STATE_CHANNEL),
+  setTrayState: (state: DesktopTrayState) => ipcRenderer.invoke(SET_TRAY_STATE_CHANNEL, state),
+  setReadyToHandleTrayMessages: (ready: boolean) =>
+    ipcRenderer.invoke(SET_READY_TO_HANDLE_TRAY_MESSAGES_CHANNEL, ready),
+  onTrayMessage: (listener) => {
+    const wrappedListener = (_event: Electron.IpcRendererEvent, message: unknown) => {
+      if (typeof message !== "object" || message === null) return;
+      listener(message as Parameters<typeof listener>[0]);
+    };
+
+    ipcRenderer.on(TRAY_MESSAGE_CHANNEL, wrappedListener);
+    return () => {
+      ipcRenderer.removeListener(TRAY_MESSAGE_CHANNEL, wrappedListener);
+    };
+  },
 } satisfies DesktopBridge);