Files

T

cyph3rasi 7c185c9b36 Hide secondary windows until the login UI is painted, open external links in the default browser, and add signed Githop auto-updates

Hop-State: A_06FPJAAEMY0VXGY9S90PE90
Hop-Proposal: R_06FPJA9RY0ZAWJ1K0K760W8
Hop-Task: T_06FPJ5688NFG8VWKSFCTZEG
Hop-Attempt: AT_06FPJ5688M08V2K0PEFVQX0

2026-07-15 21:22:22 -07:00

2.6 KiB

Raw Blame History

Synapsis Desktop

A Tauri desktop client for the Synapsis federated social network. The first-run experience follows the same node-first model as the native iOS app:

Choose and verify a Synapsis node.
Sign in with an existing account or create a new account on that node.
Continue directly into that node's real signed-in web experience.

Node and authentication requests run in Rust so independent nodes do not need to opt into browser CORS. After authentication, HttpOnly session cookies are securely handed to the native webview and the selected node's actual web client opens in the same window.

Develop

Requirements: Bun, Rust, and the platform prerequisites for Tauri 2.

bun install
bun run tauri dev

The standalone frontend preview is available with bun run dev, but node connection is intentionally disabled outside Tauri because the native command layer owns networking.

Validate

bun run build
cargo test --manifest-path src-tauri/Cargo.toml

Current scope

Animated signal-field launch and onboarding visuals.
Node URL normalization and /api/node verification.
Persistent web-session detection across app launches.
Cookie-based sign in, account creation, and sign out.
The selected node's complete website experience after authentication.

The node address and HttpOnly website session persist between launches using the native webview's cookie store.

Auto-updates

Production builds check the newest public release at GnosysLabs/Synapsis-Desktop on Githop. When a newer signed release is present, Synapsis downloads it, verifies it with the embedded updater public key, installs it, and relaunches automatically. Development builds do not check for updates.

The encrypted updater private key lives outside this repository at /Users/christopher/.tauri/synapsis-desktop-updater.key. Matching TAURI_SIGNING_PRIVATE_KEY and TAURI_SIGNING_PRIVATE_KEY_PASSWORD secrets are configured for the Githop repository. Never commit the private key or password.

To prepare a macOS update locally:

Increment version in src-tauri/tauri.conf.json, src-tauri/Cargo.toml, and package.json.
Export TAURI_SIGNING_PRIVATE_KEY and TAURI_SIGNING_PRIVATE_KEY_PASSWORD for the updater signing key.
Run bun run release to build the app, updater archive, and signature.
Run bun run release:manifest to create latest.json beside the archive.
Create a Githop release tagged v<version> and attach Synapsis.app.tar.gz, Synapsis.app.tar.gz.sig, and latest.json.

The release tag and manifest tag must match. Override the defaults with SYNAPSIS_RELEASE_TAG and SYNAPSIS_RELEASE_NOTES when needed.