slaveofcode · slaveofcode · Jul 25, 2026 · Jul 14, 2026 · Jul 14, 2026 · Jul 14, 2026
diff --git a/.github/workflows/desktop-check.yml b/.github/workflows/desktop-check.yml
@@ -0,0 +1,74 @@
+name: Desktop compile check
+
+# Compile-checks the Tauri Rust app on all three desktop targets. This is the
+# verification loop for platform-specific capture code (Windows DXGI/WGC, Linux
+# PipeWire via xcap) that can't be built on a macOS dev machine.
+
+on:
+  push:
+    branches:
+      - 'feat/**'
+      - 'fix/**'
+    paths:
+      - 'src-tauri/**'
+      - '.github/workflows/desktop-check.yml'
+  pull_request:
+    branches: [develop, main, 'feat/**']
+    paths:
+      - 'src-tauri/**'
+  workflow_dispatch:
+
+jobs:
+  check:
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-24.04
+          - os: windows-latest
+          - os: macos-latest
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Cache cargo
+        uses: Swatinem/rust-cache@v2
+        with:
+          workspaces: src-tauri
+
+      # Tauri + xcap (PipeWire/Wayland/X11/dbus) system deps on Linux.
+      - name: Install Linux deps
+        if: matrix.os == 'ubuntu-24.04'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y \
+            libwebkit2gtk-4.1-dev \
+            libgtk-3-dev \
+            libayatana-appindicator3-dev \
+            librsvg2-dev \
+            libsoup-3.0-dev \
+            libdbus-1-dev \
+            libpipewire-0.3-dev \
+            libspa-0.2-dev \
+            libwayland-dev \
+            libxcb1-dev \
+            libxcb-randr0-dev \
+            libxcb-shm0-dev \
+            libclang-dev \
+            clang \
+            pkg-config
+
+      # generate_context! embeds the frontend dist at compile time; a stub is
+      # enough for a compile check (we don't need the real built assets here).
+      - name: Stub frontend dist
+        shell: bash
+        run: |
+          mkdir -p dist
+          echo '<!doctype html><title>stub</title>' > dist/index.html
+
+      - name: cargo check (all targets)
+        working-directory: src-tauri
+        run: cargo check --all-targets
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -0,0 +1,112 @@
+name: Release Desktop App
+
+# Trigger on tags like "desktop-v1.0.0-beta.1" or "desktop-v1.2.3"
+on:
+  push:
+    tags:
+      - 'desktop-v*'
+
+jobs:
+  build:
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - platform: macos-latest
+            args: '--target aarch64-apple-darwin'
+            label: macOS (Apple Silicon)
+          - platform: macos-latest
+            args: '--target x86_64-apple-darwin'
+            label: macOS (Intel)
+          - platform: windows-latest
+            args: ''
+            label: Windows
+          - platform: ubuntu-24.04
+            args: ''
+            label: Linux
+
+    name: Build — ${{ matrix.label }}
+    runs-on: ${{ matrix.platform }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Setup Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: ${{ matrix.platform == 'macos-latest' && 'aarch64-apple-darwin,x86_64-apple-darwin' || '' }}
+
+      - name: Cache Rust
+        uses: Swatinem/rust-cache@v2
+        with:
+          workspaces: './src-tauri -> target'
+
+      - name: Install Linux system dependencies
+        if: matrix.platform == 'ubuntu-24.04'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y \
+            libwebkit2gtk-4.1-dev \
+            libappindicator3-dev \
+            librsvg2-dev \
+            patchelf \
+            libdbus-1-dev \
+            libpipewire-0.3-dev \
+            libspa-0.2-dev \
+            libwayland-dev \
+            libxcb1-dev \
+            libxcb-randr0-dev \
+            libxcb-shm0-dev \
+            libclang-dev \
+            clang \
+            pkg-config
+
+      - name: Install npm dependencies
+        run: npm ci --legacy-peer-deps
+
+      - name: Run tests
+        run: npm test -- --run
+
+      - name: Build Tauri app
+        uses: tauri-apps/tauri-action@v0
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          # Code signing — set these secrets in the repo settings
+          APPLE_CERTIFICATE: ${{ secrets.APPLE_CERTIFICATE }}
+          APPLE_CERTIFICATE_PASSWORD: ${{ secrets.APPLE_CERTIFICATE_PASSWORD }}
+          APPLE_SIGNING_IDENTITY: ${{ secrets.APPLE_SIGNING_IDENTITY }}
+          APPLE_ID: ${{ secrets.APPLE_ID }}
+          APPLE_PASSWORD: ${{ secrets.APPLE_PASSWORD }}
+          APPLE_TEAM_ID: ${{ secrets.APPLE_TEAM_ID }}
+        with:
+          tagName: ${{ github.ref_name }}
+          releaseName: 'GoodWebTools Desktop ${{ github.ref_name }}'
+          releaseBody: |
+            ## GoodWebTools Desktop ${{ github.ref_name }}
+
+            ### What's new
+            See [CHANGELOG.md](https://github.com/slaveofcode/goodwebtools/blob/main/CHANGELOG.md) for details.
+
+            ### Downloads
+            Pick the right file for your system:
+            | Platform | File |
+            |----------|------|
+            | macOS (Apple Silicon) | `*_aarch64.dmg` |
+            | macOS (Intel) | `*_x64.dmg` |
+            | Windows | `*_x64-setup.exe` |
+            | Linux (Debian/Ubuntu) | `*.deb` |
+            | Linux (AppImage) | `*.AppImage` |
+
+            ### First run on macOS
+            If macOS blocks the app, open **System Settings → Privacy & Security** and click **Open Anyway**.
+            For screen capture to work, grant **Screen Recording** permission in **Privacy & Security → Screen Recording**.
+          releaseDraft: true
+          prerelease: ${{ contains(github.ref_name, 'beta') || contains(github.ref_name, 'alpha') }}
+          args: ${{ matrix.args }}
diff --git a/.gitignore b/.gitignore
@@ -1,5 +1,7 @@
 node_modules/
 dist/
+src-tauri/target/
+src-tauri/bin/
 .astro/
 .DS_Store
 

diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -0,0 +1,62 @@
+# Changelog
+
+All notable changes to GoodWebTools are documented here.
+
+## [1.0.0-beta.1] — 2026-07-19
+
+### Desktop app (Tauri 2) — first beta release
+
+**New features**
+
+- **System-wide screenshot** via global hotkey (⌘⇧A on macOS)
+  - Multi-display picker with live thumbnails
+  - Region-selector overlay with drag-to-crop
+  - Countdown window before capture
+  - Main window auto-hides/restores around capture
+- **Screen + audio recording**
+  - Captures the full screen or a bounded region using platform-native APIs
+  - Records system/microphone audio in parallel via FFmpeg (avfoundation / dshow / pulse)
+  - Muxes audio + video on stop with graceful video-only fallback
+- **System tray** (macOS menu bar)
+  - Left-click to focus the main window
+  - "Take Screenshot" shortcut directly from the tray menu
+- **Native FFmpeg integration**
+  - Bundled sidecar binary per platform (aarch64/x86_64 macOS, Windows, Linux)
+  - Falls back to system `ffmpeg` if sidecar is absent
+  - `bundle:check` pre-build script validates sidecar presence and icon assets
+- **First-run permission wizard** (`/first-run`)
+  - Checks Screen Recording, Microphone, and FFmpeg availability
+  - One-click jump to System Preferences for each permission
+  - Marks completion so the wizard only runs once
+- **Settings page enhancements**
+  - Desktop Preferences panel (screenshot format, tray toggle, launch-at-login)
+  - Permission Status panel with live re-check
+  - Auto-Updater panel (checks GitHub Releases, downloads and relaunches in place)
+- **Download page** (`/download`)
+  - Auto-detects OS and architecture, highlights the recommended installer
+  - Links to GitHub Releases for macOS arm64/x64, Windows, Linux deb/AppImage
+- **GitHub Actions release pipeline**
+  - Builds macOS (Apple Silicon + Intel), Windows, Linux on `desktop-v*` tags
+  - Runs full test suite before every build
+  - Creates a GitHub Release (pre-release for alpha/beta tags)
+
+**Service layer**
+
+- `FileService` — native file dialogs and filesystem via `@tauri-apps/plugin-fs`
+- `ClipboardService` — native clipboard via `@tauri-apps/plugin-clipboard-manager`
+- `DownloadService` — native save dialog + ZIP support
+- `AssetService` — intelligent cache management with configurable TTL
+- `HotkeyService` — global shortcuts via `@tauri-apps/plugin-global-shortcut`
+
+**Testing**
+
+- 385 tests across 43 files (all passing)
+- Full coverage for service layer Tauri implementations
+- `global-hotkeys.ts` integration tests with module-isolation reset pattern
+
+---
+
+## [0.9.0] — prior web releases
+
+See git log for the full history of the web app phases (tools 1–55, PDF suite,
+ML image tools, Excalidraw whiteboard, SQLite playground, etc.).
diff --git a/README.md b/README.md
@@ -184,10 +184,42 @@ never leaves your device.
 Both ride one lazily-loaded, self-hosted Monaco engine — never in the shell
 payload. Nothing is uploaded.
 
+✅ **Phase 10 — Desktop app (Tauri 2):**
+- **System-wide screenshot** — global hotkey (⌘⇧A), multi-display picker, region
+  selector overlay, countdown, main window hides during capture.
+- **Screen + audio recording** — full-screen or bounded region capture via
+  platform screen APIs; audio recorded in parallel via FFmpeg (avfoundation /
+  dshow / pulse) and muxed into the final video on stop.
+- **System tray** — lives in the macOS menu bar; left-click to focus, "Take
+  Screenshot" shortcut directly in the menu.
+- **Native FFmpeg** — bundled sidecar (per-platform binary) with system fallback;
+  verified at startup via `bundle:check` script.
+- **First-run wizard** — permission check (Screen Recording, Microphone, FFmpeg)
+  with one-click jump to System Preferences.
+- **Settings** — desktop preferences (format, tray, launch-at-login), permission
+  status panel, and auto-updater UI.
+- **Auto-updater** — checks GitHub Releases on demand; downloads and relaunches
+  in place.
+- **GitHub Actions release pipeline** — matrix build for macOS (arm64 + x64),
+  Windows, and Linux on `desktop-v*` tags.
+- **Download page** — `/download` auto-detects OS/arch and highlights the right
+  installer.
+
+### Desktop development
+
+```bash
+npm run tauri:dev        # Dev server + Tauri window
+npm run tauri:build      # Release bundle (requires icon assets + FFmpeg sidecar)
+npm run download:ffmpeg  # Download platform FFmpeg sidecars to src-tauri/bin/
+npm run bundle:check     # Verify all required assets before release build
+```
+
+See [RELEASING-DESKTOP.md](./RELEASING-DESKTOP.md) for the full release guide,
+including FFmpeg sidecar setup and signing key configuration for GitHub Actions.
+
 ## Testing
 
-Unit tests cover the pure tool logic (parsers, generators, hash, image math,
-file crypto, format converters): `npm run test` — **237 tests across 25 files**.
+Unit tests cover pure tool logic and service layer: `npm run test` — **385 tests across 43 files**.
 
 ## Deployment