Add preview workflows for Windows and Linux bundles

Author: ericceg

.github/workflows/ci.yml

@@ -27,12 +27,24 @@ jobs:
         run: npm run typecheck
 
   rust-quality:
-    runs-on: macos-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        platform:
+          - ubuntu-22.04
+          - macos-latest
+          - windows-latest
+
+    runs-on: ${{ matrix.platform }}
 
     steps:
       - name: Checkout
         uses: actions/checkout@v4
 
+      - name: Install Linux system deps
+        if: matrix.platform == 'ubuntu-22.04'
+        run: bash scripts/install-tauri-linux-deps.sh
+
       - name: Setup Rust (stable + rustfmt)
         uses: dtolnay/rust-toolchain@stable
         with:

.github/workflows/preview-bundles.yml

@@ -0,0 +1,90 @@
+name: Preview Bundles
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: Version label to validate against package metadata
+        required: false
+        type: string
+      include-macos:
+        description: Also build the existing macOS bundles
+        required: false
+        default: true
+        type: boolean
+
+jobs:
+  build-preview:
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - platform: ubuntu-22.04
+            os: linux
+            bundles: deb,appimage
+            artifact_name: trajectory-linux-bundles
+            artifact_paths: |
+              src-tauri/target/release/bundle/deb/*.deb
+              src-tauri/target/release/bundle/appimage/*.AppImage
+          - platform: windows-latest
+            os: windows
+            bundles: nsis,msi
+            artifact_name: trajectory-windows-bundles
+            artifact_paths: |
+              src-tauri/target/release/bundle/nsis/*.exe
+              src-tauri/target/release/bundle/msi/*.msi
+          - platform: macos-latest
+            os: macos
+            bundles: app,dmg
+            artifact_name: trajectory-macos-bundles
+            artifact_paths: |
+              src-tauri/target/release/bundle/macos/*.app
+              src-tauri/target/release/bundle/dmg/*.dmg
+
+    runs-on: ${{ matrix.platform }}
+    if: ${{ matrix.os != 'macos' || inputs.include-macos }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install Linux system deps
+        if: matrix.os == 'linux'
+        run: bash scripts/install-tauri-linux-deps.sh
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+
+      - name: Setup Rust (stable)
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Rust cache
+        uses: swatinem/rust-cache@v2
+        with:
+          workspaces: ./src-tauri -> target
+
+      - name: Install frontend deps
+        run: npm ci
+
+      - name: Verify version alignment
+        shell: bash
+        run: |
+          expected_version="${{ inputs.version }}"
+          if [[ -z "$expected_version" ]]; then
+            expected_version="$(node -p "require('./package.json').version")"
+          fi
+          bash scripts/verify-version-alignment.sh "$expected_version"
+
+      - name: Build desktop bundles
+        run: npm run tauri build -- --bundles ${{ matrix.bundles }}
+
+      - name: Upload preview artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: ${{ matrix.artifact_name }}
+          path: ${{ matrix.artifact_paths }}
+          if-no-files-found: error
+          retention-days: 14

.github/workflows/release.yml

@@ -6,15 +6,33 @@ on:
       - 'v*'
 
 jobs:
-  build-macos:
-    runs-on: macos-latest
+  build-release:
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - platform: macos-latest
+            os: macos
+            bundles: app,dmg
+          - platform: windows-latest
+            os: windows
+            bundles: nsis,msi
+          - platform: ubuntu-22.04
+            os: linux
+            bundles: deb,appimage
+
+    runs-on: ${{ matrix.platform }}
     permissions:
       contents: write
 
     steps:
       - name: Checkout
         uses: actions/checkout@v4
 
+      - name: Install Linux system deps
+        if: matrix.os == 'linux'
+        run: bash scripts/install-tauri-linux-deps.sh
+
       - name: Setup Node
         uses: actions/setup-node@v4
         with:
@@ -24,21 +42,20 @@ jobs:
       - name: Setup Rust (stable)
         uses: dtolnay/rust-toolchain@stable
 
+      - name: Rust cache
+        uses: swatinem/rust-cache@v2
+        with:
+          workspaces: ./src-tauri -> target
+
       - name: Install frontend deps
         run: npm ci
 
       - name: Verify tag/version alignment
-        run: |
-          TAG_VERSION="${GITHUB_REF_NAME#v}"
-          APP_VERSION=$(node -p "require('./package.json').version")
-          TAURI_VERSION=$(node -p "require('./src-tauri/tauri.conf.json').version")
-          CARGO_VERSION=$(sed -n 's/^version = "\(.*\)"/\1/p' src-tauri/Cargo.toml | head -n 1)
-          if [ "$TAG_VERSION" != "$APP_VERSION" ] || [ "$TAG_VERSION" != "$TAURI_VERSION" ] || [ "$TAG_VERSION" != "$CARGO_VERSION" ]; then
-            echo "Tag ($TAG_VERSION), package.json ($APP_VERSION), tauri.conf.json ($TAURI_VERSION), and Cargo.toml ($CARGO_VERSION) must match"
-            exit 1
-          fi
+        shell: bash
+        run: bash scripts/verify-version-alignment.sh "${GITHUB_REF_NAME#v}"
 
       - name: Configure macOS ad-hoc signing (no notarization)
+        if: matrix.os == 'macos'
         run: |
           echo "Building macOS release artifacts with ad-hoc signing (APPLE_SIGNING_IDENTITY='-')."
           echo "Apple Developer ID signing and notarization are intentionally disabled for CI prototype builds."
@@ -55,23 +72,4 @@ jobs:
           releaseDraft: false
           prerelease: false
           includeUpdaterJson: false
-          args: --bundles app,dmg
-
-      - name: Verify bundled artifacts exist
-        run: |
-          shopt -s nullglob
-          app_bundles=(src-tauri/target/release/bundle/macos/*.app)
-          dmg_bundles=(src-tauri/target/release/bundle/dmg/*.dmg)
-
-          if [ ${#app_bundles[@]} -eq 0 ]; then
-            echo "No .app bundle was generated."
-            exit 1
-          fi
-
-          if [ ${#dmg_bundles[@]} -eq 0 ]; then
-            echo "No .dmg installer was generated."
-            exit 1
-          fi
-
-          echo "App bundle: ${app_bundles[0]}"
-          echo "DMG installer: ${dmg_bundles[0]}"
+          args: --bundles ${{ matrix.bundles }}

README.md

@@ -1,7 +1,7 @@
 # Trajectory
 
 [![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
-![Platform](https://img.shields.io/badge/platform-macOS-lightgrey)
+![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-lightgrey)
 [![Framework](https://img.shields.io/badge/framework-Tauri%20v2-yellow)](https://tauri.app/)
 [![Backend](https://img.shields.io/badge/backend-Rust-orange)](https://www.rust-lang.org/)
 [![Frontend](https://img.shields.io/badge/frontend-React%20%2B%20TypeScript-3178c6)](https://reactjs.org/)
@@ -33,6 +33,7 @@ There is no single reason for why I built Trajectory, but rather a combination o
 Notes:
 - Current release builds are ad-hoc signed, so macOS may show a security warning on first launch.
 - If you cannot open the app, follow the instructions on [Apple's support site](https://support.apple.com/guide/mac-help/open-a-mac-app-from-an-unknown-developer-mh40616/mac).
+- Windows and Linux bundles can be built as preview artifacts from the `Preview Bundles` GitHub Actions workflow before publishing an official release.
 
 
 
@@ -206,7 +207,9 @@ can be useful to convince your loved ones that your hobby is not that dangerous
 
 ## Platform Support
 
-- macOS
+- macOS release artifacts
+- Windows preview bundles via GitHub Actions
+- Linux preview bundles via GitHub Actions
 
 ## Developer Setup (Build From Source)
 
@@ -240,6 +243,10 @@ Output artifacts are generated under:
 
 - `src-tauri/target/release/bundle/macos/*.app`
 - `src-tauri/target/release/bundle/dmg/*.dmg`
+- `src-tauri/target/release/bundle/nsis/*.exe`
+- `src-tauri/target/release/bundle/msi/*.msi`
+- `src-tauri/target/release/bundle/deb/*.deb`
+- `src-tauri/target/release/bundle/appimage/*.AppImage`
 
 ### Documentation
 
@@ -255,7 +262,7 @@ Output artifacts are generated under:
 ## Roadmap
 
 - Route planner.
-- Windows and Linux support.
+- Code signing / hardening for Windows and Linux releases.
 
 
 

docs/DEVELOPER_GUIDE.md

@@ -1,6 +1,6 @@
 # Trajectory Developer Guide
 
-> Last verified against the codebase: **April 7, 2026**
+> Last verified against the codebase: **April 8, 2026**
 
 This guide is for contributors working on Trajectory's desktop app codebase.
 It is intentionally practical: what exists today, how it fits together, and how to extend it safely.
@@ -11,7 +11,8 @@ It is intentionally practical: what exists today, how it fits together, and how
 
 - Node.js 22+
 - Rust stable toolchain
-- macOS (primary supported platform for local dev and release)
+- macOS (primary supported platform for local dev)
+- GitHub Actions for preview/release builds on macOS, Windows, and Linux
 
 ### Install and run
 
@@ -41,6 +42,10 @@ Artifacts are created under:
 
 - `src-tauri/target/release/bundle/macos/*.app`
 - `src-tauri/target/release/bundle/dmg/*.dmg`
+- `src-tauri/target/release/bundle/nsis/*.exe`
+- `src-tauri/target/release/bundle/msi/*.msi`
+- `src-tauri/target/release/bundle/deb/*.deb`
+- `src-tauri/target/release/bundle/appimage/*.AppImage`
 
 ## 2. Product Scope (Current)
 
@@ -74,7 +79,8 @@ Important behavior:
 | `src-tauri/` | Tauri shell + Rust backend |
 | `docs/DEVELOPER_GUIDE.md` | This document |
 | `.github/workflows/ci.yml` | Typecheck + Rust quality gate |
-| `.github/workflows/release.yml` | Tag-based macOS release pipeline |
+| `.github/workflows/preview-bundles.yml` | Manual preview bundle pipeline for artifact testing |
+| `.github/workflows/release.yml` | Tag-based macOS/Windows/Linux release pipeline |
 
 ### Project Structure
 
@@ -103,6 +109,7 @@ Important behavior:
 └── .github/
     └── workflows/
         ├── ci.yml
+        ├── preview-bundles.yml
         └── release.yml
 ```
 
@@ -369,10 +376,23 @@ Design choices:
 - frontend quality job on Ubuntu:
   - `npm ci`
   - `npm run typecheck`
-- rust quality job on macOS:
+- rust quality job on Ubuntu, macOS, and Windows:
+  - Linux runner installs Tauri system dependencies (`libwebkit2gtk-4.1-dev`, `libappindicator3-dev`, `librsvg2-dev`, `patchelf`)
   - `cargo check --manifest-path src-tauri/Cargo.toml`
   - `cargo fmt --manifest-path src-tauri/Cargo.toml --all -- --check`
 
+### Preview bundles (`.github/workflows/preview-bundles.yml`)
+
+Triggered manually from GitHub Actions.
+
+Builds downloadable artifacts without creating a GitHub release:
+
+- macOS: `.app` + `.dmg` (optional)
+- Windows: `.exe` (NSIS) + `.msi`
+- Linux: `.deb` + `.AppImage`
+
+Use this workflow to validate that a branch is release-ready and hand the generated bundles to testers before tagging a real release.
+
 ### Release (`.github/workflows/release.yml`)
 
 Triggered by tags matching `v*`.
@@ -384,7 +404,11 @@ Pipeline verifies version alignment across:
 - `src-tauri/tauri.conf.json`
 - `src-tauri/Cargo.toml`
 
-Then builds and publishes `.app` + `.dmg` via `tauri-apps/tauri-action` with ad-hoc signing.
+Then builds and publishes platform bundles via `tauri-apps/tauri-action`:
+
+- macOS: `.app` + `.dmg` with ad-hoc signing
+- Windows: `.exe` (NSIS) + `.msi`
+- Linux: `.deb` + `.AppImage`
 
 ## 11. Common Extension Tasks
 

scripts/install-tauri-linux-deps.sh

@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+sudo apt-get update
+sudo apt-get install -y \
+  libwebkit2gtk-4.1-dev \
+  libappindicator3-dev \
+  librsvg2-dev \
+  patchelf

scripts/verify-version-alignment.sh

@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+if [[ $# -ne 1 ]]; then
+  echo "usage: $0 <version>" >&2
+  exit 1
+fi
+
+expected_version="$1"
+package_version="$(node -p "require('./package.json').version")"
+tauri_version="$(node -p "require('./src-tauri/tauri.conf.json').version")"
+cargo_version="$(sed -n 's/^version = "\(.*\)"/\1/p' src-tauri/Cargo.toml | head -n 1)"
+
+if [[ "$expected_version" != "$package_version" ]] || [[ "$expected_version" != "$tauri_version" ]] || [[ "$expected_version" != "$cargo_version" ]]; then
+  echo "Version mismatch detected." >&2
+  echo "Expected: $expected_version" >&2
+  echo "package.json: $package_version" >&2
+  echo "src-tauri/tauri.conf.json: $tauri_version" >&2
+  echo "src-tauri/Cargo.toml: $cargo_version" >&2
+  exit 1
+fi