M10.2: Tauri v2 desktop scaffold (desktop/) — Vue frontend as the webview

New desktop/ Tauri v2 project (Linux-first, cross-platform-ready):
- src-tauri: Cargo.toml (lib + thin main.rs shim), build.rs, lib.rs (Builder
  entry point), tauri.conf.json (frontendDist -> ../../frontend/dist, devUrl
  :5173, deb+appimage bundles), capabilities/default.json (core:default),
  .gitignore.
- The shared Vue 3 frontend is the sibling ../frontend; before-commands cd via
  "$(git rev-parse --show-toplevel)/frontend" since frontend and src-tauri are
  siblings, not nested.
- Icons generated from frontend/public/icon.svg via `cargo tauri icon` in CI
  (M10.8), not committed.

Boots the shared UI in a native window. The local data adapter (M10.3/M10.5)
and CI build verification (M10.8) follow. desktop/** is not yet in the CI paths
filter — added with the desktop lane in M10.8.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FRgehjoz7Yv8LkUfADxACm

desktop/README.md

@@ -0,0 +1,61 @@
+# ThoughtSync desktop (Tauri v2)
+
+Local-first desktop client. The window loads the shared **Vue 3 frontend** from
+`../frontend`; the Rust core (`src-tauri`) owns the on-device store and the opt-in
+sync engine (built out across the M10 milestone). Works fully offline; optionally
+syncs to a self-hosted ThoughtSync server.
+
+## Layout
+
+```
+desktop/
+  src-tauri/
+    Cargo.toml
+    build.rs
+    tauri.conf.json          # frontendDist -> ../../frontend/dist, devUrl :5173
+    capabilities/default.json
+    src/
+      main.rs                # thin shim -> lib::run()
+      lib.rs                 # tauri::Builder entry point
+```
+
+The Vue frontend is the sibling `../frontend` package, **shared with the web
+build**. On desktop it is backed by a local data source via
+`frontend/src/adapters/` (M10.3) instead of the server REST API. `frontend` and
+`src-tauri` are **siblings, not nested**, so the `beforeDev`/`beforeBuild`
+commands `cd "$(git rev-parse --show-toplevel)/frontend"` to resolve regardless of
+the CLI's working directory.
+
+## Prerequisites
+
+The toolchain (Rust + Node + WebKitGTK 4.1 + `tauri-cli`) is provided by the
+`ci-tauri` CI image. For local dev: install Rust + Node, `cargo install tauri-cli`,
+and the Tauri v2 Linux system deps — see `CI-tauri/Dockerfile` in the CI-runner
+repo for the exact apt list (libwebkit2gtk-4.1-dev, libgtk-3-dev, librsvg2-dev,
+libayatana-appindicator3-dev, libxdo-dev, patchelf, ...).
+
+## Dev
+
+```sh
+cd desktop/src-tauri && cargo tauri dev
+```
+
+`beforeDevCommand` starts the Vite dev server (port 5173) in `../frontend`.
+
+## Build (Linux)
+
+```sh
+cargo tauri icon "$(git rev-parse --show-toplevel)/frontend/public/icon.svg"
+cd desktop/src-tauri && cargo tauri build   # -> .deb + .AppImage
+```
+
+App icons are **generated** from the frontend's `icon.svg` via `cargo tauri icon`
+(not committed; CI does this before `cargo tauri build`). Bundle targets: `deb`,
+`appimage` (Linux-first; Windows/macOS later, no code changes expected).
+
+## Status
+
+Scaffold (M10.2): boots the shared Vue UI in a native window. Until the local data
+adapter lands (M10.3 + M10.5) the app has no server configured, so it shows the
+login screen without a working backend — full offline functionality arrives with
+the local SQLite store (M10.4) + `adapters/local.ts` (M10.5).

desktop/src-tauri/.gitignore

@@ -0,0 +1,9 @@
+# Generated by Cargo
+/target/
+
+# Generated by Tauri
+/gen/schemas
+
+# App icons are generated from ../../frontend/public/icon.svg via `cargo tauri
+# icon` (in CI before the build); not committed.
+/icons/

desktop/src-tauri/Cargo.toml

@@ -0,0 +1,28 @@
+[package]
+name = "thoughtsync-desktop"
+version = "0.1.0"
+description = "ThoughtSync desktop — local-first Keep-style thought capture"
+authors = ["bvandeusen"]
+edition = "2021"
+
+# App logic lives in the library (Tauri v2 pattern: a single `run()` entry point
+# reusable across desktop and any future mobile target); main.rs is a thin shim.
+[lib]
+name = "thoughtsync_desktop_lib"
+crate-type = ["staticlib", "cdylib", "rlib"]
+
+[build-dependencies]
+tauri-build = { version = "2", features = [] }
+
+[dependencies]
+tauri = { version = "2", features = [] }
+serde = { version = "1", features = ["derive"] }
+serde_json = "1"
+
+# Tauri's default release profile: smaller, faster shipped binaries.
+[profile.release]
+codegen-units = 1
+lto = true
+opt-level = "s"
+panic = "abort"
+strip = true

desktop/src-tauri/build.rs

@@ -0,0 +1,3 @@
+fn main() {
+    tauri_build::build()
+}

desktop/src-tauri/capabilities/default.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "../gen/schemas/desktop-schema.json",
+  "identifier": "default",
+  "description": "Core capability for the main ThoughtSync window.",
+  "windows": ["main"],
+  "permissions": ["core:default"]
+}

desktop/src-tauri/src/lib.rs

@@ -0,0 +1,13 @@
+//! ThoughtSync desktop (Tauri v2).
+//!
+//! The window loads the shared Vue 3 frontend (`../../frontend`). Today this is the
+//! shell that boots the UI; the Rust core will own the on-device SQLite store
+//! (M10.4) and the opt-in sync engine (M10.7), which the frontend reaches through
+//! the `frontend/src/adapters/` seam (M10.3) over Tauri `invoke`.
+
+#[cfg_attr(mobile, tauri::mobile_entry_point)]
+pub fn run() {
+    tauri::Builder::default()
+        .run(tauri::generate_context!())
+        .expect("error while running the ThoughtSync desktop app");
+}

desktop/src-tauri/src/main.rs

@@ -0,0 +1,7 @@
+// Prevents an extra console window on Windows in release builds. No effect on
+// Linux/macOS. The real entry point is the library's `run()` (Tauri v2 pattern).
+#![cfg_attr(not(debug_assertions), windows_subsystem = "windows")]
+
+fn main() {
+    thoughtsync_desktop_lib::run()
+}

desktop/src-tauri/tauri.conf.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "https://schema.tauri.app/config/2",
+  "productName": "ThoughtSync",
+  "version": "0.1.0",
+  "identifier": "com.fabledsword.thoughtsync",
+  "build": {
+    "frontendDist": "../../frontend/dist",
+    "devUrl": "http://localhost:5173",
+    "beforeDevCommand": "cd \"$(git rev-parse --show-toplevel)/frontend\" && npm run dev",
+    "beforeBuildCommand": "cd \"$(git rev-parse --show-toplevel)/frontend\" && npm ci && npm run build"
+  },
+  "app": {
+    "windows": [
+      {
+        "label": "main",
+        "title": "ThoughtSync",
+        "width": 1100,
+        "height": 780,
+        "minWidth": 480,
+        "minHeight": 600,
+        "resizable": true,
+        "center": true
+      }
+    ],
+    "security": {
+      "csp": null
+    }
+  },
+  "bundle": {
+    "active": true,
+    "targets": ["deb", "appimage"],
+    "category": "Utility",
+    "shortDescription": "Local-first Keep-style thought capture.",
+    "longDescription": "ThoughtSync captures a fleeting thought in a second on a Keep-style board and grows into a lightweight second brain. Local-first: works fully offline on an on-device store, and optionally syncs to your self-hosted ThoughtSync server.",
+    "icon": [
+      "icons/32x32.png",
+      "icons/128x128.png",
+      "icons/128x128@2x.png",
+      "icons/icon.icns",
+      "icons/icon.ico"
+    ]
+  }
+}