feat: auto-updater, menu improvements, onboarding reopen

mehdiraized · claude · mehdiraized · commit 2b6c53d2f7ff · 2026-03-23T00:46:07.000+04:00
- Add electron/updater.js: checks GitHub releases API for newer version,
  shows 'Download Update' dialog, auto-checks after 30s then every 24h
- Add 'Check for Updates…' to macOS app menu and Help menu
- Add 'Show Intro…' to Help menu (dispatches im-show-onboarding event)
- Add Widget menu now has submenu: Widget (⌘⇧W) and Text (⌘⇧T)
- onboarding.tsx: listen for im-show-onboarding window event to re-show
- Fix: add --publish never to all build:* scripts to prevent
  electron-builder auto-publishing (conflicts with softprops/action-gh-release)

Co-Authored-By: Claude Sonnet 4.6 &lt;noreply@anthropic.com&gt;
diff --git a/electron/main.js b/electron/main.js
@@ -21,6 +21,7 @@ const net = require('net');
 const fs = require('fs');
 
 const { buildMenu } = require('./menu');
+const { scheduleUpdateCheck } = require('./updater');
 
 // ── Constants ────────────────────────────────────────────────────────────────
 
@@ -701,6 +702,7 @@ app.whenReady().then(async () => {
     await waitForServer(appPort, 90_000, serverAbort.signal);
     serverAbort = null;
     loadApp();
+    scheduleUpdateCheck(mainWindow);
   } catch (err) {
     serverAbort = null;
     console.error('[main] startup failed:', err);
diff --git a/electron/menu.js b/electron/menu.js
@@ -2,6 +2,7 @@
 
 const { Menu, shell, app } = require('electron');
 const { openSettingsWindow } = require('./settings-window');
+const { checkForUpdates } = require('./updater');
 
 /**
  * Builds and sets the application menu.
@@ -20,6 +21,10 @@ function buildMenu({ isDevMode, mainWindow }) {
             label: app.name,
             submenu: [
               { role: 'about' },
+              {
+                label: 'Check for Updates…',
+                click() { checkForUpdates(mainWindow, true); },
+              },
               { type: 'separator' },
               {
                 label: 'Settings…',
@@ -57,15 +62,30 @@ function buildMenu({ isDevMode, mainWindow }) {
         { type: 'separator' },
         {
           label: 'Add Widget',
-          accelerator: 'CmdOrCtrl+Shift+W',
-          click() {
-            if (mainWindow) {
-              // Click the Add button in the web app header to open the dropdown
-              mainWindow.webContents.executeJavaScript(
-                `document.querySelector('[data-add-menu-trigger]')?.click()`
-              );
-            }
-          },
+          submenu: [
+            {
+              label: 'Widget',
+              accelerator: 'CmdOrCtrl+Shift+W',
+              click() {
+                if (mainWindow) {
+                  mainWindow.webContents.executeJavaScript(
+                    `document.querySelector('[data-add-menu-trigger]')?.click()`
+                  );
+                }
+              },
+            },
+            {
+              label: 'Text',
+              accelerator: 'CmdOrCtrl+Shift+T',
+              click() {
+                if (mainWindow) {
+                  mainWindow.webContents.executeJavaScript(
+                    `document.querySelector('[data-add-text-trigger]')?.click()`
+                  );
+                }
+              },
+            },
+          ],
         },
         { type: 'separator' },
         {
@@ -147,6 +167,21 @@ function buildMenu({ isDevMode, mainWindow }) {
     {
       role: 'help',
       submenu: [
+        {
+          label: 'Show Intro…',
+          click() {
+            if (mainWindow) {
+              mainWindow.webContents.executeJavaScript(
+                `window.dispatchEvent(new CustomEvent('im-show-onboarding'))`
+              );
+            }
+          },
+        },
+        {
+          label: 'Check for Updates…',
+          click() { checkForUpdates(mainWindow, true); },
+        },
+        { type: 'separator' },
         {
           label: 'Infinite Monitor on GitHub',
           click() {
diff --git a/electron/updater.js b/electron/updater.js
@@ -0,0 +1,153 @@
+'use strict';
+
+const https = require('https');
+const { app, dialog, shell } = require('electron');
+
+const RELEASES_API_URL = 'https://api.github.com/repos/mehdiraized/infinite-monitor-desktop/releases/latest';
+const USER_AGENT = 'infinite-monitor-desktop/1.0.0';
+
+// 24 hours in milliseconds
+const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
+// Initial delay before first background check (30 seconds)
+const INITIAL_DELAY_MS = 30 * 1000;
+
+/**
+ * Parses a semver string like "v1.2.3" or "1.2.3" into [major, minor, patch].
+ * Returns [0, 0, 0] if parsing fails.
+ * @param {string} version
+ * @returns {[number, number, number]}
+ */
+function parseSemver(version) {
+  const clean = version.replace(/^v/, '').trim();
+  const parts = clean.split('.').map((p) => parseInt(p, 10) || 0);
+  return [parts[0] || 0, parts[1] || 0, parts[2] || 0];
+}
+
+/**
+ * Returns true if `remote` is strictly newer than `local`.
+ * Compares major, then minor, then patch numerically.
+ * @param {string} local   e.g. "1.0.0"
+ * @param {string} remote  e.g. "v1.2.0"
+ * @returns {boolean}
+ */
+function isNewerVersion(local, remote) {
+  const [lMaj, lMin, lPat] = parseSemver(local);
+  const [rMaj, rMin, rPat] = parseSemver(remote);
+
+  if (rMaj !== lMaj) return rMaj > lMaj;
+  if (rMin !== lMin) return rMin > lMin;
+  return rPat > lPat;
+}
+
+/**
+ * Fetches the latest release info from GitHub.
+ * Resolves with { tag_name, html_url } or rejects on network/parse error.
+ * @returns {Promise<{ tag_name: string, html_url: string }>}
+ */
+function fetchLatestRelease() {
+  return new Promise((resolve, reject) => {
+    const req = https.get(
+      RELEASES_API_URL,
+      {
+        headers: {
+          'User-Agent': USER_AGENT,
+          Accept: 'application/vnd.github+json',
+        },
+      },
+      (res) => {
+        let body = '';
+        res.on('data', (chunk) => { body += chunk; });
+        res.on('end', () => {
+          try {
+            const json = JSON.parse(body);
+            if (!json.tag_name) {
+              reject(new Error('No tag_name in response'));
+              return;
+            }
+            resolve({ tag_name: json.tag_name, html_url: json.html_url });
+          } catch (err) {
+            reject(new Error(`Failed to parse GitHub response: ${err.message}`));
+          }
+        });
+      }
+    );
+
+    req.on('error', (err) => {
+      reject(new Error(`Network error: ${err.message}`));
+    });
+
+    // 10 second timeout
+    req.setTimeout(10_000, () => {
+      req.destroy(new Error('Request timed out'));
+    });
+  });
+}
+
+/**
+ * Checks GitHub for a newer release and prompts the user if one is found.
+ *
+ * @param {Electron.BrowserWindow | null} mainWindow
+ * @param {boolean} isManual  When true, always show a result dialog (even if up-to-date or on error).
+ */
+async function checkForUpdates(mainWindow, isManual = false) {
+  const currentVersion = app.getVersion();
+
+  try {
+    const { tag_name, html_url } = await fetchLatestRelease();
+    const latestVersion = tag_name.replace(/^v/, '');
+
+    if (isNewerVersion(currentVersion, tag_name)) {
+      // Update is available — prompt the user
+      const { response } = await dialog.showMessageBox({
+        type: 'info',
+        title: 'Update Available',
+        message: `Infinite Monitor v${latestVersion} is available.\nYou're running v${currentVersion}.`,
+        buttons: ['Download Update', 'Later'],
+        defaultId: 0,
+        cancelId: 1,
+      });
+
+      if (response === 0) {
+        shell.openExternal(html_url);
+      }
+    } else if (isManual) {
+      // Already on the latest version — inform the user only when they asked manually
+      await dialog.showMessageBox({
+        type: 'info',
+        title: 'No Update Available',
+        message: `You're up to date! v${currentVersion} is the latest version.`,
+        buttons: ['OK'],
+      });
+    }
+  } catch (err) {
+    console.error('[updater] check failed:', err.message);
+    if (isManual) {
+      await dialog.showMessageBox({
+        type: 'warning',
+        title: 'Update Check Failed',
+        message: 'Could not check for updates. Check your internet connection.',
+        buttons: ['OK'],
+      });
+    }
+  }
+}
+
+/**
+ * Schedules automatic (silent) update checks.
+ * First check runs after INITIAL_DELAY_MS (30 s), then repeats every 24 h.
+ *
+ * @param {Electron.BrowserWindow | null} mainWindow
+ */
+function scheduleUpdateCheck(mainWindow) {
+  // Initial check after 30 seconds
+  setTimeout(() => {
+    checkForUpdates(mainWindow, false);
+
+    // Subsequent checks every 24 hours
+    setInterval(() => {
+      checkForUpdates(mainWindow, false);
+    }, CHECK_INTERVAL_MS);
+  }, INITIAL_DELAY_MS);
+}
+
+module.exports = { checkForUpdates, scheduleUpdateCheck };
diff --git a/overlay/src/components/onboarding.tsx b/overlay/src/components/onboarding.tsx
@@ -301,6 +301,22 @@ export function Onboarding() {
     }
   }, []);
 
+  // Allow the Electron menu ("Show Intro…") to re-trigger the onboarding
+  // without a full page reload, by dispatching a custom window event.
+  useEffect(() => {
+    if (typeof window === "undefined") return;
+    function handleShowOnboarding() {
+      setSlide(0);
+      setLeaving(false);
+      setDir(1);
+      setVisible(true);
+    }
+    window.addEventListener("im-show-onboarding", handleShowOnboarding);
+    return () => {
+      window.removeEventListener("im-show-onboarding", handleShowOnboarding);
+    };
+  }, []);
+
   const dismiss = useCallback(() => {
     localStorage.setItem(ONBOARDING_KEY, "1");
     setVisible(false);
diff --git a/package.json b/package.json
@@ -16,10 +16,10 @@
     "release": "node scripts/release.js",
     "predev": "node scripts/apply-overlay.js",
     "dev": "cross-env NODE_ENV=development electron .",
-    "build": "node scripts/apply-overlay.js && pnpm run generate-icons && pnpm run prepare-web && electron-builder",
-    "build:mac": "node scripts/apply-overlay.js && pnpm run generate-icons && pnpm run prepare-web && electron-builder --mac",
-    "build:win": "node scripts/apply-overlay.js && pnpm run generate-icons && pnpm run prepare-web && electron-builder --win",
-    "build:linux": "node scripts/apply-overlay.js && pnpm run generate-icons && pnpm run prepare-web && electron-builder --linux",
+    "build": "node scripts/apply-overlay.js && pnpm run generate-icons && pnpm run prepare-web && electron-builder --publish never",
+    "build:mac": "node scripts/apply-overlay.js && pnpm run generate-icons && pnpm run prepare-web && electron-builder --mac --publish never",
+    "build:win": "node scripts/apply-overlay.js && pnpm run generate-icons && pnpm run prepare-web && electron-builder --win --publish never",
+    "build:linux": "node scripts/apply-overlay.js && pnpm run generate-icons && pnpm run prepare-web && electron-builder --linux --publish never",
     "generate-icons": "node scripts/generate-icons.js",
     "prepare-web": "node scripts/prepare-web.js",
     "apply-overlay": "node scripts/apply-overlay.js",
