cyph3rasi
7c185c9b36
Hop-State: A_06FPJAAEMY0VXGY9S90PE90 Hop-Proposal: R_06FPJA9RY0ZAWJ1K0K760W8 Hop-Task: T_06FPJ5688NFG8VWKSFCTZEG Hop-Attempt: AT_06FPJ5688M08V2K0PEFVQX0
64 lines
2.6 KiB
Markdown
64 lines
2.6 KiB
Markdown
# 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:
|
|
|
|
1. Choose and verify a Synapsis node.
|
|
2. Sign in with an existing account or create a new account on that node.
|
|
3. 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.
|
|
|
|
```sh
|
|
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
|
|
|
|
```sh
|
|
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:
|
|
|
|
1. Increment `version` in `src-tauri/tauri.conf.json`, `src-tauri/Cargo.toml`, and
|
|
`package.json`.
|
|
2. Export `TAURI_SIGNING_PRIVATE_KEY` and
|
|
`TAURI_SIGNING_PRIVATE_KEY_PASSWORD` for the updater signing key.
|
|
3. Run `bun run release` to build the app, updater archive, and signature.
|
|
4. Run `bun run release:manifest` to create `latest.json` beside the archive.
|
|
5. 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.
|