Release Candidate v1.0

.github/update-npm-version/action.yml

@@ -0,0 +1,31 @@
+name: Update npm version
+
+description: Updates the global npm version based on the `devEngines` field of a package.json
+
+inputs:
+  package-json-path:
+    description: Path pointing to package.json file. Attempts to use the one in current directory by default.
+    required: false
+    default: './package.json'
+
+outputs:
+  npm-version:
+    description: Installed npm version
+    value: ${{ steps.update-npm.npm-version }}
+
+runs:
+  using: composite
+  steps:
+    - name: Update npm
+      id: update-npm
+      shell: bash
+      env:
+        PACKAGE_JSON_PATH: ${{ inputs.package-json-path }}
+      run: |
+        version=$(cat "$PACKAGE_JSON_PATH" | jq '.devEngines.packageManager.version' --raw-output)
+
+        echo "Version detected: $version"
+
+        npm install -g npm@$version
+
+        echo "npm-version=$(npm --version)" >> $GITHUB_OUTPUT

.github/workflows/ci.yml

@@ -15,31 +15,45 @@ concurrency:
   cancel-in-progress: ${{ github.ref_name != github.event.repository.default_branch }}
 
 jobs:
-  lint:
+  checks:
     runs-on: ubuntu-latest
     timeout-minutes: 10
     steps:
       - uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
       - name: Use Node.js
-        uses: actions/setup-node@395ad3262231945c25e8478fd5baf05154b1d79f # v6.1.0
+        id: setup-node
+        uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
         with:
           node-version-file: '.nvmrc'
 
       - name: Update npm version
-        shell: bash
-        run: |
-          version=$(cat package.json | jq '.devEngines.packageManager.version' --raw-output)
-          echo "Version detected: $version"
-          npm install -g npm@$version
+        uses: ./.github/update-npm-version
 
       - name: Install deps
         run: npm ci
 
+      - name: Check Electron node version
+        shell: bash
+        env:
+          EXPECTED_NODE_VERSION: ${{ steps.setup-node.outputs.node-version }}
+        run: |
+          electron_node_version=$(ELECTRON_RUN_AS_NODE=true npx electron -e 'console.log(process.versions.node);')
+
+          # Version string from setup-node is prefixed with "v"
+          if [[ "v$electron_node_version" == "$EXPECTED_NODE_VERSION" ]]
+          then
+            echo "✅ Electron node version matches expected ($electron_node_version)"
+          else
+            echo "⛔️ Electron node version ($electron_node_version) does not match expected ($EXPECTED_NODE_VERSION)"
+            exit 1
+          fi
+
       - name: Build translations
         run: node --run intl
 
-      - name: Run lint
-        run: node --run lint
+      - name: Run checks
+        run: node --run checks
+
   test:
     timeout-minutes: 10
     strategy:
@@ -52,16 +66,12 @@ jobs:
       - uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
 
       - name: Use Node.js
-        uses: actions/setup-node@395ad3262231945c25e8478fd5baf05154b1d79f # v6.1.0
+        uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
         with:
           node-version-file: '.nvmrc'
 
       - name: Update npm version
-        shell: bash
-        run: |
-          version=$(cat package.json | jq '.devEngines.packageManager.version' --raw-output)
-          echo "Version detected: $version"
-          npm install -g npm@$version
+        uses: ./.github/update-npm-version
 
       - name: Install deps
         run: npm ci
@@ -92,16 +102,12 @@ jobs:
       - uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
 
       - name: Use Node.js
-        uses: actions/setup-node@395ad3262231945c25e8478fd5baf05154b1d79f # v6.1.0
+        uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
         with:
           node-version-file: '.nvmrc'
 
       - name: Update npm version
-        shell: bash
-        run: |
-          version=$(cat package.json | jq '.devEngines.packageManager.version' --raw-output)
-          echo "Version detected: $version"
-          npm install -g npm@$version
+        uses: ./.github/update-npm-version
 
       - name: Install deps
         run: npm ci
@@ -119,22 +125,14 @@ jobs:
 
       - name: Run e2e tests
         if: ${{ matrix.os.name != 'linux'}}
-        uses: nick-fields/retry@ce71cc2ab81d554ebbe88c79ab5975992d79ba08 # v3.0.2
-        with:
-          timeout_minutes: 5
-          max_attempts: 3
-          command: node --run test-e2e
+        run: node --run test-e2e
 
         # NOTE: Addresses issue with app not launching (https://github.com/microsoft/playwright/issues/34251#issuecomment-2580645333)
       - name: Run e2e tests (Linux)
         if: ${{ matrix.os.name == 'linux'}}
-        uses: nick-fields/retry@ce71cc2ab81d554ebbe88c79ab5975992d79ba08 # v3.0.2
-        with:
-          timeout_minutes: 5
-          max_attempts: 3
-          command: |
-            sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0
-            xvfb-run --auto-servernum --server-args="-screen 0 1280x960x24" -- node --run test-e2e
+        run: |
+          sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0
+          xvfb-run --auto-servernum --server-args="-screen 0 1280x960x24" -- node --run test-e2e
 
       - name: Upload Playwright report
         if: ${{ !cancelled() }}

.github/workflows/create-builds.yml

@@ -72,16 +72,12 @@ jobs:
           fetch-depth: 0
 
       - name: Set up Node.js
-        uses: actions/setup-node@395ad3262231945c25e8478fd5baf05154b1d79f # v6.1.0
+        uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
         with:
           node-version-file: .nvmrc
 
       - name: Update npm version
-        shell: bash
-        run: |
-          version=$(cat package.json | jq '.devEngines.packageManager.version' --raw-output)
-          echo "Version detected: $version"
-          npm install -g npm@$version
+        uses: ./.github/update-npm-version
 
       - name: Install dependencies
         run: npm ci

.github/workflows/hotfix-release.yml

@@ -69,16 +69,12 @@ jobs:
           token: ${{ steps.app-token.outputs.token }}
 
       - name: Setup Node.js
-        uses: actions/setup-node@395ad3262231945c25e8478fd5baf05154b1d79f # v6.1.0
+        uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
         with:
           node-version-file: .nvmrc
 
       - name: Update npm version
-        shell: bash
-        run: |
-          version=$(cat package.json | jq '.devEngines.packageManager.version' --raw-output)
-          echo "Version detected: $version"
-          npm install -g npm@$version
+        uses: ./.github/update-npm-version
 
       - name: Parse version
         id: version

.github/workflows/scheduled-release.yml

@@ -49,16 +49,12 @@ jobs:
           token: ${{ steps.app-token.outputs.token }}
 
       - name: Setup Node.js
-        uses: actions/setup-node@395ad3262231945c25e8478fd5baf05154b1d79f # v6.1.0
+        uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
         with:
           node-version-file: .nvmrc
 
       - name: Update npm version
-        shell: bash
-        run: |
-          version=$(cat package.json | jq '.devEngines.packageManager.version' --raw-output)
-          echo "Version detected: $version"
-          npm install -g npm@$version
+        uses: ./.github/update-npm-version
 
       - name: Parse version
         id: version

.nvmrc

@@ -1,3 +1,3 @@
 # We keep this aligned with the Node version that comes with Electron
 
-22.21.1
+24.11.1

.tool-versions

@@ -1,3 +1,3 @@
 # We keep this aligned with the Node version that comes with Electron
 
-nodejs 22.21.1
+nodejs 24.11.1

README.md

@@ -6,8 +6,8 @@ Go to the [Development](./docs/DEVELOPMENT.md) docs to learn about how the proje
 
 Make sure you have the preferred versions of tooling installed:
 
-- [`NodeJS`](https://nodejs.org): [22.21.1](./.nvmrc)
-- [`npm`](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm): 11.7.0
+- [`NodeJS`](https://nodejs.org): [24.11.1](./.nvmrc)
+- [`npm`](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm): 11.8.0
 
 1. Clone the repo:
 

forge.config.ts

@@ -3,6 +3,7 @@ import { mkdirSync } from 'node:fs'
 import fs from 'node:fs/promises'
 import { arch, platform } from 'node:os'
 import path from 'node:path'
+import { loadEnvFile } from 'node:process'
 import { fileURLToPath } from 'node:url'
 import { MakerDeb } from '@electron-forge/maker-deb'
 import { MakerDMG } from '@electron-forge/maker-dmg'
@@ -12,6 +13,11 @@ import { MakerZIP } from '@electron-forge/maker-zip'
 import { AutoUnpackNativesPlugin } from '@electron-forge/plugin-auto-unpack-natives'
 import { PluginBase } from '@electron-forge/plugin-base'
 import { FusesPlugin } from '@electron-forge/plugin-fuses'
+import type {
+	ForgeConfig,
+	ForgeConfigPlugin,
+	ForgeHookFn,
+} from '@electron-forge/shared-types'
 import { FuseV1Options, FuseVersion } from '@electron/fuses'
 import { MakerAppImage } from '@reforged/maker-appimage'
 import semver from 'semver'
@@ -21,13 +27,11 @@ import { build, createServer, type ViteDevServer } from 'vite'
 import packageJSON from './package.json' with { type: 'json' }
 import type { AppConfig, AppType } from './src/shared/app.ts'
 
-import 'dotenv/config'
-
-import type {
-	ForgeConfig,
-	ForgeConfigPlugin,
-	ForgeHookFn,
-} from '@electron-forge/shared-types'
+try {
+	loadEnvFile()
+} catch (err) {
+	console.warn(`Failed to load .env file: ${err}`)
+}
 
 const {
 	APP_TYPE,

knip.config.ts

@@ -14,7 +14,7 @@ export default {
 	project: [
 		'src/**/*.{js,ts,jsx,tsx}!',
 		'scripts/*.{js,ts}',
-		'tests-e2e/*.{js,ts}',
+		'tests-e2e/**/*.{js,ts}',
 		'*.{js,ts}',
 	],
 	ignore: [

messages/renderer/de.json

@@ -23,6 +23,10 @@
     "description": "Text for button to reload page.",
     "message": "Reload"
   },
+  "components.generic-route-error-component.restart": {
+    "description": "Text for button to restart app.",
+    "message": "Neustart"
+  },
   "components.generic-route-error-component.somethinWentWrong": {
     "description": "Title text of page error",
     "message": "Etwas ist schief gelaufen"
@@ -539,6 +543,10 @@
     "description": "Text displayed when waiting for Wi-Fi information.",
     "message": "Lade Wi-Fi-Informationen…"
   },
+  "routes.app.projects.$projectId_.invite.devices.index.goBackAccessibleLabel": {
+    "description": "Accessible label for back button",
+    "message": "Gehe zurück."
+  },
   "routes.app.projects.$projectId_.invite.devices.index.navTitle": {
     "description": "Title of the device selection for invite page.",
     "message": "Gerät auswählen"
@@ -547,6 +555,10 @@
     "description": "Detail about how to control data sharing.",
     "message": "Freigabe in den Projekteinstellungen kontrollieren."
   },
+  "routes.app.projects.$projectId_.invite.index.goBackAccessibleLabel": {
+    "description": "Accessible label for back button.",
+    "message": "Gehe zurück."
+  },
   "routes.app.projects.$projectId_.invite.index.inviteCollaborators": {
     "description": "Title of the Invite Get Started page.",
     "message": "Mitarbeiter einladen"
@@ -707,6 +719,10 @@
     "description": "Text indicating collaborator is a coordinator.",
     "message": "Koordinator"
   },
+  "routes.app.projects.$projectId_.team.$deviceId.goBackAccessibleLabel": {
+    "description": "Accessible label for back button.",
+    "message": "Gehe zurück."
+  },
   "routes.app.projects.$projectId_.team.$deviceId.lastCoordinatorWarning": {
     "description": "Warning text about leaving the project as the last coordinator.",
     "message": "Sie sind der letzte Koordinator. Überlegen Sie, ein anderes Gerät zu einem Koordinator zu machen, bevor Sie das Projekt verlassen."

messages/renderer/en.json

@@ -23,6 +23,10 @@
     "description": "Text for button to reload page.",
     "message": "Reload"
   },
+  "components.generic-route-error-component.restart": {
+    "description": "Text for button to restart app.",
+    "message": "Restart"
+  },
   "components.generic-route-error-component.somethinWentWrong": {
     "description": "Title text of page error",
     "message": "Something went wrong"
@@ -539,6 +543,10 @@
     "description": "Text displayed when waiting for Wi-Fi information.",
     "message": "Getting Wi-Fi information…"
   },
+  "routes.app.projects.$projectId_.invite.devices.index.goBackAccessibleLabel": {
+    "description": "Accessible label for back button",
+    "message": "Go back."
+  },
   "routes.app.projects.$projectId_.invite.devices.index.navTitle": {
     "description": "Title of the device selection for invite page.",
     "message": "Select a Device"
@@ -547,6 +555,10 @@
     "description": "Detail about how to control data sharing.",
     "message": "Control sharing in Project Settings."
   },
+  "routes.app.projects.$projectId_.invite.index.goBackAccessibleLabel": {
+    "description": "Accessible label for back button.",
+    "message": "Go back."
+  },
   "routes.app.projects.$projectId_.invite.index.inviteCollaborators": {
     "description": "Title of the Invite Get Started page.",
     "message": "Invite Collaborators"

messages/renderer/es.json

@@ -23,6 +23,10 @@
     "description": "Text for button to reload page.",
     "message": "Reload"
   },
+  "components.generic-route-error-component.restart": {
+    "description": "Text for button to restart app.",
+    "message": "Reiniciar"
+  },
   "components.generic-route-error-component.somethinWentWrong": {
     "description": "Title text of page error",
     "message": "Algo salió mal"
@@ -531,6 +535,10 @@
     "description": "Text displayed when waiting for Wi-Fi information.",
     "message": "Obteniendo información Wi-Fi…"
   },
+  "routes.app.projects.$projectId_.invite.devices.index.goBackAccessibleLabel": {
+    "description": "Accessible label for back button",
+    "message": "Regresar."
+  },
   "routes.app.projects.$projectId_.invite.devices.index.navTitle": {
     "description": "Title of the device selection for invite page.",
     "message": "Seleccione un dispositivo"
@@ -539,6 +547,10 @@
     "description": "Detail about how to control data sharing.",
     "message": "Control para compartir en la configuración del proyecto."
   },
+  "routes.app.projects.$projectId_.invite.index.goBackAccessibleLabel": {
+    "description": "Accessible label for back button.",
+    "message": "Regresar."
+  },
   "routes.app.projects.$projectId_.invite.index.inviteCollaborators": {
     "description": "Title of the Invite Get Started page.",
     "message": "Invita colaboradores"
@@ -699,6 +711,10 @@
     "description": "Text indicating collaborator is a coordinator.",
     "message": "Persona Coordinadora"
   },
+  "routes.app.projects.$projectId_.team.$deviceId.goBackAccessibleLabel": {
+    "description": "Accessible label for back button.",
+    "message": "Regresar."
+  },
   "routes.app.projects.$projectId_.team.$deviceId.lastCoordinatorWarning": {
     "description": "Warning text about leaving the project as the last coordinator.",
     "message": "Eres el último coordinator. Considera hacer otro dispositivo un coordinator antes de abandonar el proyecto."