Merge remote-tracking branch 'origin/final_changes' into release_BC

Author: dedicatedbroadcastsolutions

README.md

@@ -97,6 +97,7 @@ The internal web server binds to **all network interfaces** (`0.0.0.0`) by defau
 - Use the full path including the trailing slash: `/gui/` (e.g. `http://localhost:5500/gui/`) so assets load correctly.
 - The Web UI uses the same API and WebSocket connection as the desktop app; the machine running SuperConductor must be reachable on port `5500` from the browser.
 - CORS is configured to allow browser clients from any origin; the API and real-time updates work when the browser is on another machine.
+- **Development (`yarn start` from repo root):** The Web UI is served from the built frontend in the `build` folder. That folder is created when you run **`yarn build`** (from the repo root). If you only run `yarn start` without building first, `/gui/` will return 404 until you run `yarn build` once. This applies on all platforms (including Windows).
 
 ## HTTP API
 

apps/app/src/electron/api/ApiServer.ts

@@ -1,3 +1,4 @@
+import fs from 'fs'
 import path from 'path'
 import { EverythingService } from '../EverythingService.js'
 import { LoggerLike } from '@shared/api'
@@ -100,11 +101,22 @@ export class ApiServer {
 		{
 			let guiUrlPath: string
 			if (app.isPackaged) {
-				// In production/packaged mode, build folder is in the app path
 				guiUrlPath = path.resolve(app.getAppPath(), 'build')
 			} else {
-				// In development mode, build folder is relative to app path
-				guiUrlPath = path.resolve(app.getAppPath(), '../build')
+				// In development: Vite outputs to <app>/build. Prefer app path, fallback to cwd (e.g. Windows + yarn start).
+				const appPathBuild = path.resolve(app.getAppPath(), 'build')
+				const cwdBuild = path.resolve(process.cwd(), 'build')
+				guiUrlPath =
+					fs.existsSync(appPathBuild) && fs.statSync(appPathBuild).isDirectory()
+						? appPathBuild
+						: fs.existsSync(cwdBuild) && fs.statSync(cwdBuild).isDirectory()
+							? cwdBuild
+							: appPathBuild
+				if (!fs.existsSync(guiUrlPath) || !fs.statSync(guiUrlPath).isDirectory()) {
+					log.warn(
+						`Web GUI build folder not found at ${guiUrlPath}. Run "yarn build" (or "vite build" in apps/app) once to enable the Web UI at /gui/`
+					)
+				}
 			}
 
 			// Add redirect from /gui to /gui/ for proper asset loading (must be before static serving)