Add electron as an alternative runtime to Tauri

.github/workflows/flatpak.yml

@@ -73,8 +73,8 @@ jobs:
           gh release download "$TAG" \
             --repo "$RELEASE_REPO" \
             --dir downloads \
-            --pattern "Quadrant_${VERSION}_amd64.deb" \
-            --pattern "Quadrant_${VERSION}_arm64.deb"
+            --pattern "Quadrant-${VERSION}-linux-x64-electron.AppImage" \
+            --pattern "Quadrant-${VERSION}-linux-arm64-electron.AppImage"
 
       - name: Compute source hashes
         id: hashes
@@ -84,8 +84,8 @@ jobs:
           set -euo pipefail
 
           metainfo_sha="$(sha256sum "$METAINFO_PATH" | awk '{print $1}')"
-          amd64_sha="$(sha256sum "downloads/Quadrant_${VERSION}_amd64.deb" | awk '{print $1}')"
-          arm64_sha="$(sha256sum "downloads/Quadrant_${VERSION}_arm64.deb" | awk '{print $1}')"
+          amd64_sha="$(sha256sum "downloads/Quadrant-${VERSION}-linux-x64-electron.AppImage" | awk '{print $1}')"
+          arm64_sha="$(sha256sum "downloads/Quadrant-${VERSION}-linux-arm64-electron.AppImage" | awk '{print $1}')"
 
           echo "metainfo_sha=$metainfo_sha" >> "$GITHUB_OUTPUT"
           echo "amd64_sha=$amd64_sha" >> "$GITHUB_OUTPUT"
@@ -192,8 +192,8 @@ jobs:
           set -euo pipefail
 
           metainfo_url="https://github.com/${RELEASE_REPO}/raw/${TAG}/${METAINFO_PATH}"
-          amd64_url="https://github.com/${RELEASE_REPO}/releases/download/${TAG}/Quadrant_${VERSION}_amd64.deb"
-          arm64_url="https://github.com/${RELEASE_REPO}/releases/download/${TAG}/Quadrant_${VERSION}_arm64.deb"
+          amd64_url="https://github.com/${RELEASE_REPO}/releases/download/${TAG}/Quadrant-${VERSION}-linux-x64-electron.AppImage"
+          arm64_url="https://github.com/${RELEASE_REPO}/releases/download/${TAG}/Quadrant-${VERSION}-linux-arm64-electron.AppImage"
           pr_head="${FLATHUB_HEAD_OWNER}:${FLATHUB_BRANCH}"
 
           {

.github/workflows/release.yml

@@ -37,7 +37,6 @@ jobs:
       - name: Setup bun
         uses: oven-sh/setup-bun@v2
 
-
       - name: install Rust stable
         uses: dtolnay/rust-toolchain@stable
 
@@ -71,12 +70,74 @@ jobs:
           releaseDraft: false
           prerelease: ${{ !endsWith(github.ref_name, 'stable') }}
           args: ${{ matrix.args }}
-          tauriScript: 'bun tauri'
+          tauriScript: "bun tauri"
           tagName: ${{github.ref_name}}
 
+  publish-electron:
+    permissions:
+      contents: write
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - platform: "blacksmith-4vcpu-windows-2025"
+            os: "windows"
+            arch: "x64"
+          - platform: "blacksmith-4vcpu-ubuntu-2404"
+            os: "linux"
+            arch: "x64"
+          - platform: "windows-11-arm"
+            os: "windows"
+            arch: "arm64"
+          - platform: "blacksmith-4vcpu-ubuntu-2404-arm"
+            os: "linux"
+            arch: "arm64"
+    runs-on: ${{ matrix.platform }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup bun
+        uses: oven-sh/setup-bun@v2
+
+      - name: install Rust stable
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: install dependencies (ubuntu only)
+        if: matrix.os == 'linux'
+        run: |
+          sudo apt update
+          sudo apt install -y libsecret-1-dev libarchive-tools rpm
+
+      - name: install frontend dependencies (bun)
+        run: bun install
+
+      - uses: Swatinem/rust-cache@v2
+        with:
+          workspaces: "./src-tauri -> target"
+
+      - name: Package Electron app
+        env:
+          ETERNAL_API_TOKEN: ${{ secrets.ETERNAL_API_TOKEN }}
+          QUADRANT_API_KEY: ${{ secrets.QUADRANT_API_KEY }}
+          QUADRANT_OAUTH2_CLIENT_ID: ${{ secrets.QUADRANT_OAUTH2_CLIENT_ID }}
+          QUADRANT_OAUTH2_CLIENT_SECRET: ${{ secrets.QUADRANT_OAUTH2_CLIENT_SECRET }}
+          QUADRANT_API_BASE_URL: ${{ vars.QUADRANT_API_BASE_URL }}
+        run: bun run package:electron -- --arch=${{ matrix.arch }}
+
+      - name: Upload Electron assets to release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          TAG_NAME: ${{ github.ref_name }}
+        shell: bash
+        run: |
+          mapfile -d '' files < <(find dist-electron -maxdepth 1 -type f -print0)
+          gh release upload "$TAG_NAME" "${files[@]}" --clobber
+
   sync_flathub:
     name: Sync Flathub
-    needs: publish-tauri
+    needs:
+      - publish-tauri
+      - publish-electron
     if: endsWith(github.ref_name, '-stable') || endsWith(github.ref_name, '-flatpak')
     uses: ./.github/workflows/flatpak.yml
     secrets: inherit

.github/workflows/validate-desktop.yml

@@ -0,0 +1,52 @@
+name: Validate Desktop
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+      - master
+      - release
+
+jobs:
+  validate:
+    runs-on: ubuntu-24.04
+    env:
+      # quadrant-core still uses compile-time env!() for these desktop-only
+      # credentials, so CI must provide placeholder values for every Rust build.
+      QUADRANT_API_KEY: dev
+      QUADRANT_OAUTH2_CLIENT_ID: dev
+      QUADRANT_OAUTH2_CLIENT_SECRET: dev
+      ETERNAL_API_TOKEN: dev
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup bun
+        uses: oven-sh/setup-bun@v2
+
+      - name: Install Rust stable
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Install Linux desktop dependencies
+        run: |
+          sudo apt update
+          sudo apt install -y libwebkit2gtk-4.1-dev xdg-utils libappindicator3-dev librsvg2-dev patchelf libsecret-1-dev libarchive-tools rpm
+
+      - name: Install frontend dependencies
+        run: bun install
+
+      - uses: Swatinem/rust-cache@v2
+        with:
+          workspaces: "./src-tauri -> target"
+
+      - name: Build shared renderer
+        run: bun run build
+
+      - name: Build native addon
+        run: bun run build:napi
+
+      - name: Build Electron shell
+        run: node scripts/build-electron.mjs
+
+      - name: Build Tauri shell
+        run: bun tauri build --no-bundle

.gitignore

@@ -9,6 +9,7 @@ lerna-debug.log*
 
 node_modules
 dist
+dist-electron
 dist-ssr
 *.local
 
@@ -39,3 +40,5 @@ src-tauri/versoview
 target/
 AppxContent
 AppxBundles
+electron/runtime-config.generated.json
+packages/quadrant-node/native/

.vscode/settings.json

@@ -1,6 +1,4 @@
 {
-    "rust-analyzer.cargo.cfgs": [
-        "debug_assertions"
-    ],
-    "typescript.tsdk": "node_modules\\typescript\\lib"
-}
+  "rust-analyzer.cargo.cfgs": ["debug_assertions"],
+  "typescript.tsdk": "node_modules\\typescript\\lib"
+}

AppxManifest.xml

@@ -8,7 +8,7 @@
     xmlns:desktop="http://schemas.microsoft.com/appx/manifest/desktop/windows10"
     xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities"
     IgnorableNamespaces="uap uap3 uap10 desktop rescap">
-    <Identity Name="58734MrQuantumOFFDemirYer.MinecraftModpackManagerR" Version="26.4.0.0"
+    <Identity Name="58734MrQuantumOFFDemirYer.MinecraftModpackManagerR" Version="26.4.1.0"
         Publisher="CN=010914FC-8843-4963-A3FE-E3E06E6D9F53" ProcessorArchitecture="x64" />
     <Properties>
         <DisplayName>QuadrantMC</DisplayName>

DEVELOP.md

@@ -4,4 +4,10 @@ You can develop the Quadrant Next client by:
 
 - Installing the needed dependencies for [Tauri](https://tauri.app/start/prerequisites/) and [Rust](https://www.rust-lang.org/). If you're on Linux, you'll also need libsecret-1-dev.
 - Then install bun and run `bun install` in the root directory of the project.
-- After that in order to run the app without any of the proprietary features, you can run `bun tauri dev -- -- --no-default-features`.
+- Renderer-only development remains available through `bun run dev`.
+- Tauri development is available through `bun run dev:tauri`.
+- Electron development is available through `bun run dev:electron`.
+- To build the shared renderer only, run `bun run build`.
+- To build the native Electron addon explicitly, run `bun run build:napi`.
+- To package the Electron app, run `bun run package:electron`.
+- To build the Tauri app without any of the proprietary features, run `bun tauri dev -- -- --no-default-features`.

README.md

@@ -4,6 +4,13 @@
 
 > An easy way to manage your modpacks, written in React and Rust.
 
+## Desktop Runtimes
+
+Quadrant supports two desktop runtimes, they share the frontend and backend logic, but differ in technicalities:
+
+- `Tauri`: the original Quadrant experience.
+- `Electron`: the Node/Electron shell in `electron/`, backed by the Quadrant N-API bindings, should work better on Linux, because it replaces WebKit with CEF.
+
 ### Installation guide:
 
 ##### The app is available on these stores: