From db24d7ea180bff760b17b6b9b51346e7839bd4a0 Mon Sep 17 00:00:00 2001 From: Bryan Van Deusen Date: Fri, 24 Jul 2026 11:13:09 -0400 Subject: [PATCH] =?UTF-8?q?M10.2:=20Tauri=20v2=20desktop=20scaffold=20(des?= =?UTF-8?q?ktop/)=20=E2=80=94=20Vue=20frontend=20as=20the=20webview?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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) Claude-Session: https://claude.ai/code/session_01FRgehjoz7Yv8LkUfADxACm --- desktop/README.md | 61 +++++++++++++++++++++ desktop/src-tauri/.gitignore | 9 +++ desktop/src-tauri/Cargo.toml | 28 ++++++++++ desktop/src-tauri/build.rs | 3 + desktop/src-tauri/capabilities/default.json | 7 +++ desktop/src-tauri/src/lib.rs | 13 +++++ desktop/src-tauri/src/main.rs | 7 +++ desktop/src-tauri/tauri.conf.json | 43 +++++++++++++++ 8 files changed, 171 insertions(+) create mode 100644 desktop/README.md create mode 100644 desktop/src-tauri/.gitignore create mode 100644 desktop/src-tauri/Cargo.toml create mode 100644 desktop/src-tauri/build.rs create mode 100644 desktop/src-tauri/capabilities/default.json create mode 100644 desktop/src-tauri/src/lib.rs create mode 100644 desktop/src-tauri/src/main.rs create mode 100644 desktop/src-tauri/tauri.conf.json diff --git a/desktop/README.md b/desktop/README.md new file mode 100644 index 0000000..62afcb0 --- /dev/null +++ b/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). diff --git a/desktop/src-tauri/.gitignore b/desktop/src-tauri/.gitignore new file mode 100644 index 0000000..3b90f41 --- /dev/null +++ b/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/ diff --git a/desktop/src-tauri/Cargo.toml b/desktop/src-tauri/Cargo.toml new file mode 100644 index 0000000..13016ae --- /dev/null +++ b/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 diff --git a/desktop/src-tauri/build.rs b/desktop/src-tauri/build.rs new file mode 100644 index 0000000..d860e1e --- /dev/null +++ b/desktop/src-tauri/build.rs @@ -0,0 +1,3 @@ +fn main() { + tauri_build::build() +} diff --git a/desktop/src-tauri/capabilities/default.json b/desktop/src-tauri/capabilities/default.json new file mode 100644 index 0000000..1116ed7 --- /dev/null +++ b/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"] +} diff --git a/desktop/src-tauri/src/lib.rs b/desktop/src-tauri/src/lib.rs new file mode 100644 index 0000000..c03b073 --- /dev/null +++ b/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"); +} diff --git a/desktop/src-tauri/src/main.rs b/desktop/src-tauri/src/main.rs new file mode 100644 index 0000000..67b61b1 --- /dev/null +++ b/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() +} diff --git a/desktop/src-tauri/tauri.conf.json b/desktop/src-tauri/tauri.conf.json new file mode 100644 index 0000000..0223b71 --- /dev/null +++ b/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" + ] + } +}