chore: Update dev run

electron/window/create-window.ts

@@ -11,6 +11,7 @@ import * as fs from 'fs';
 import * as path from 'path';
 import { DESKTOP_APP_DISPLAY_NAME } from '../app/desktop-branding.rules';
 import { readDesktopSettings } from '../desktop-settings';
+import { resolveDevelopmentClientUrl } from './dev-client-url.rules';
 
 let mainWindow: BrowserWindow | null = null;
 let tray: Tray | null = null;
@@ -277,11 +278,7 @@ export async function createWindow(): Promise<void> {
   }
 
   if (process.env['NODE_ENV'] === 'development') {
-    const devUrl = process.env['SSL'] === 'true'
-      ? 'https://localhost:4200'
-      : 'http://localhost:4200';
-
-    await mainWindow.loadURL(devUrl);
+    await mainWindow.loadURL(resolveDevelopmentClientUrl(process.env['SSL'] === 'true'));
 
     if (process.env['DEBUG_DEVTOOLS'] === '1') {
       mainWindow.webContents.openDevTools();

electron/window/dev-client-url.rules.spec.ts

@@ -0,0 +1,26 @@
+import {
+  describe,
+  expect,
+  it
+} from 'vitest';
+
+import {
+  DEV_CLIENT_HOST,
+  DEV_CLIENT_PORT,
+  resolveDevelopmentClientUrl
+} from './dev-client-url.rules';
+
+describe('dev-client-url.rules', () => {
+  it('targets loopback IPv4 so dev wait-on avoids stale localhost IPv6 listeners', () => {
+    expect(DEV_CLIENT_HOST).toBe('127.0.0.1');
+    expect(DEV_CLIENT_PORT).toBe(4200);
+  });
+
+  it('builds the HTTP dev client URL', () => {
+    expect(resolveDevelopmentClientUrl(false)).toBe('http://127.0.0.1:4200');
+  });
+
+  it('builds the HTTPS dev client URL', () => {
+    expect(resolveDevelopmentClientUrl(true)).toBe('https://127.0.0.1:4200');
+  });
+});

electron/window/dev-client-url.rules.ts

@@ -0,0 +1,8 @@
+export const DEV_CLIENT_HOST = '127.0.0.1';
+export const DEV_CLIENT_PORT = 4200;
+
+export function resolveDevelopmentClientUrl(sslEnabled: boolean): string {
+  const scheme = sslEnabled ? 'https' : 'http';
+
+  return `${scheme}://${DEV_CLIENT_HOST}:${DEV_CLIENT_PORT}`;
+}