Merge pull request #399 from HyperloopUPV-H8/control-station/electron-mac

feat: add Intel macOS distributives, change main README.md to include macOS fix

Author: Humanoidear

.github/workflows/release.yaml

@@ -41,10 +41,29 @@ jobs:
     needs: determine-version
     runs-on: ${{ matrix.os }}
     strategy:
-      fail-fast: false
+      fail-fast: true
       matrix:
-        os: [ubuntu-latest, windows-latest, macos-latest]
+        os: [windows-latest, ubuntu-latest, macos-latest, macos-15-intel]
     steps:
+      - name: Debug all contexts
+        run: |
+          echo "=== Runner Context ==="
+          echo "runner.os: ${{ runner.os }}"
+          echo "runner.arch: ${{ runner.arch }}"
+          echo "runner.name: ${{ runner.name }}"
+          echo "runner.temp: ${{ runner.temp }}"
+          echo "runner.workspace: ${{ runner.workspace }}"
+          echo ""
+          echo "=== Matrix Context ==="
+          echo "matrix.os: ${{ matrix.os }}"
+          echo "matrix.platform: ${{ matrix.platform }}"
+          echo "matrix.arch: ${{ matrix.arch }}"
+          echo ""
+          echo "=== Environment Variables ==="
+          echo "RUNNER_OS: $RUNNER_OS"
+          echo "RUNNER_ARCH: $RUNNER_ARCH"
+          echo "RUNNER_NAME: $RUNNER_NAME"
+
       - name: Checkout repository
         uses: actions/checkout@v4
 
@@ -83,9 +102,8 @@ jobs:
           name: backend-windows
           path: electron-app/binaries
 
-      # macOS needs both Intel and ARM64 for universal support
       - name: Download macOS Intel backend
-        if: runner.os == 'macOS'
+        if: runner.os == 'macOS' && runner.arch == 'X64'
         uses: dawidd6/action-download-artifact@v3
         with:
           workflow: build.yaml
@@ -95,7 +113,7 @@ jobs:
           path: electron-app/binaries
 
       - name: Download macOS ARM64 backend
-        if: runner.os == 'macOS'
+        if: runner.os == 'macOS' && runner.arch == 'ARM64'
         uses: dawidd6/action-download-artifact@v3
         with:
           workflow: build.yaml
@@ -140,20 +158,20 @@ jobs:
           ELECTRON_BUILDER_PUBLISH: never
 
       - name: Display structure (Windows)
-        if: matrix.os == 'windows-latest'
+        if: runner.os == 'Windows'
         working-directory: electron-app
         shell: pwsh
         run: Get-ChildItem -Recurse dist/ | Select-Object FullName
 
       - name: Display structure (Unix)
-        if: matrix.os != 'windows-latest'
+        if: runner.os != 'Windows'
         working-directory: electron-app
         run: ls -laR dist/
 
       - name: Upload electron artifacts
         uses: actions/upload-artifact@v4
         with:
-          name: electron-${{ runner.os }}
+          name: electron-${{ runner.os }}-${{ runner.arch }}
           path: |
             electron-app/dist/*.exe
             electron-app/dist/*.AppImage

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 HyperloopUPV
+Copyright (c) 2025 Hyperloop UPV
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

backend/cmd/main.go

@@ -76,7 +76,7 @@ const (
 
 var configFile = flag.String("config", "config.toml", "path to configuration file")
 var traceLevel = flag.String("trace", "info", "set the trace level (\"fatal\", \"error\", \"warn\", \"info\", \"debug\", \"trace\")")
-var traceFile = flag.String("log", "trace.json", "set the trace log file")
+var traceFile = flag.String("log", "", "set the trace log file")
 var cpuprofile = flag.String("cpuprofile", "", "write cpu profile to file")
 var enableSNTP = flag.Bool("sntp", false, "enables a simple SNTP server on port 123")
 var networkDevice = flag.Int("dev", -1, "index of the network device to use, overrides device prompt")

electron-app/README.md

@@ -75,6 +75,14 @@ npm run dist:mac    # macOS
 npm run dist:linux  # Linux
 ```
 
+### macOS Requirements
+
+On macOS, the backend requires the loopback address `127.0.0.9` to be configured. If you encounter a "can't assign requested address" error when starting the backend, run:
+
+```
+sudo ipconfig set en0 INFORM 127.0.0.9
+```
+
 ## Available Scripts
 
 ```

electron-app/package.json

@@ -90,15 +90,17 @@
         "zip"
       ],
       "icon": "icon.icns",
-      "category": "public.app-category.utilities"
+      "category": "public.app-category.utilities",
+      "artifactName": "${productName}-${version}-macos-${arch}.${ext}"
     },
     "linux": {
       "target": [
         "AppImage",
         "deb"
       ],
       "icon": "icon.png",
-      "category": "Utility"
+      "category": "Utility",
+      "artifactName": "${productName}-${version}-linux-${arch}.${ext}"
     }
   }
-}
+}

electron-app/src/processes/backend.js

@@ -22,6 +22,9 @@ const appPath = getAppPath();
 // Store the backend process instance
 let backendProcess = null;
 
+// Store error messages (keep last 10 lines to avoid memory issues)
+let lastBackendError = null;
+
 /**
  * Starts the backend process by spawning the backend binary with the user configuration.
  * @returns {void}
@@ -57,6 +60,14 @@ function startBackend() {
     logger.backend.info(`${data.toString().trim()}`);
   });
 
+  // Capture stderr output (where Go errors/panics are written)
+  backendProcess.stderr.on("data", (data) => {
+    const errorMsg = data.toString().trim();
+    logger.backend.error(errorMsg);
+    // Store the last error message
+    lastBackendError = errorMsg;
+  });
+
   // Handle spawn errors
   backendProcess.on("error", (error) => {
     logger.backend.error(`Failed to start backend: ${error.message}`);
@@ -71,10 +82,18 @@ function startBackend() {
     logger.backend.info(`Backend process exited with code ${code}`);
     // Show error dialog if process crashed (non-zero exit code)
     if (code !== 0 && code !== null) {
-      dialog.showErrorBox(
-        "Backend Crashed",
-        `Backend exited with code ${code}`
-      );
+      // Build error message with actual error details
+      let errorMessage = `Backend exited with code ${code}`;
+
+      if (lastBackendError) {
+        errorMessage += `\n\n${lastBackendError}`;
+      } else {
+        errorMessage += "\n\n(No error output captured)";
+      }
+
+      dialog.showErrorBox("Backend Crashed", errorMessage);
+      // Clear error message after showing
+      lastBackendError = null;
     }
   });
 }