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
This commit is contained in:
Claude Opus 4.8
@@ -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).
|
||||
@@ -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/
|
||||
@@ -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
|
||||
@@ -0,0 +1,3 @@
|
||||
fn main() {
|
||||
tauri_build::build()
|
||||
}
|
||||
@@ -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"]
|
||||
}
|
||||
@@ -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");
|
||||
}
|
||||
@@ -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()
|
||||
}
|
||||
@@ -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"
|
||||
]
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user