# yokeshwarb/qurb architecture

> Architecture diagram of the GitHub repository yokeshwarb/qurb, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/yokeshwarb/qurb
- Repository: https://github.com/yokeshwarb/qurb

## Overview

qurb is private, device-to-device cloud storage: users set up a device, pair another, and sync files directly with end-to-end encryption. Desktop and Android interfaces expose file management and sharing, while the shared Rust engine handles synchronization, storage, keys, and peer communication. Rendezvous helps devices discover and connect; a separate relay implementation forwards opaque traffic, though the README says server deployment is not yet built. Some internal wiring is not shown in the excerpts, so uncertain relationships are omitted or marked unverified.

Main entry points: [`crates/engine/src/lib.rs`](https://github.com/yokeshwarb/qurb/blob/main/crates/engine/src/lib.rs) (Sync engine), [`crates/qurb/src/daemon.rs`](https://github.com/yokeshwarb/qurb/blob/main/crates/qurb/src/daemon.rs) (CLI and daemon), [`crates/peer/src/connect.rs`](https://github.com/yokeshwarb/qurb/blob/main/crates/peer/src/connect.rs) (Peer connection), [`crates/desktop/src/main.rs`](https://github.com/yokeshwarb/qurb/blob/main/crates/desktop/src/main.rs) (Desktop window)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["User clients"]
  node_desktop["Desktop window<br/>[main.rs]"]
  node_desktop_commands["Desktop commands<br/>[commands.rs]"]
  node_cli["CLI and daemon<br/>[daemon.rs]"]
  node_android_ui["Android app<br/>[MainActivity.kt]"]
  node_android_bridge["Android engine bridge<br/>[Qurb.kt]"]
  node_android_sync["Android sync worker<br/>[SyncWorker.kt]"]
  node_mobile_ffi["Mobile FFI<br/>[lib.rs]"]
end

subgraph group_core["Sync and storage"]
  node_engine["Sync engine<br/>[lib.rs]"]
  node_reconcile["Version reconciliation<br/>[reconcile.rs]"]
  node_storage[("File store<br/>[store.rs]")]
  node_watcher["Filesystem watcher<br/>[watcher.rs]"]
  node_keys["Key management<br/>[vault.rs]"]
end

subgraph group_network["Device networking"]
  node_peer_client["Peer client<br/>[client.rs]"]
  node_peer_connect["Peer connection<br/>[connect.rs]"]
  node_peer_server["Peer server<br/>[server.rs]"]
end

subgraph group_services["Connection services"]
  node_signal_client["Rendezvous client<br/>[client.rs]"]
  node_signal_server["Rendezvous service<br/>[server.rs]"]
  node_relay["Opaque relay<br/>[server.rs]"]
end

node_user(("Device owner"))

node_user -->|"uses"| node_desktop
node_user -->|"uses"| node_android_ui
node_desktop -->|"invokes"| node_desktop_commands
node_desktop -->|"hosts daemon"| node_cli
node_user -->|"runs setup and sync"| node_cli
node_android_ui -->|"calls"| node_android_bridge
node_android_bridge -->|"uses bindings"| node_mobile_ffi
node_android_sync -.->|"runs sync"| node_mobile_ffi
node_cli -.->|"runs sync engine"| node_engine
node_engine -.->|"stores file data"| node_storage
node_engine -.->|"resolves versions"| node_reconcile
node_engine -.->|"syncs with peers"| node_peer_client
node_engine -.->|"serves peers"| node_peer_server
node_engine -.->|"uses device keys"| node_keys
node_cli -.->|"tracks file changes"| node_watcher
node_peer_client -->|"establishes connection"| node_peer_connect
node_peer_client -->|"fetches content"| node_storage
node_peer_server -->|"answers requests"| node_storage
node_peer_connect -.->|"discovers peers"| node_signal_client
node_signal_client -->|"exchanges rendezvous messages"| node_signal_server
node_signal_server -.->|"introduces devices"| node_peer_connect
node_peer_connect -.->|"falls back to relay"| node_relay

click node_desktop "https://github.com/yokeshwarb/qurb/blob/main/crates/desktop/src/main.rs"
click node_desktop_commands "https://github.com/yokeshwarb/qurb/blob/main/crates/desktop/src/commands.rs"
click node_cli "https://github.com/yokeshwarb/qurb/blob/main/crates/qurb/src/daemon.rs"
click node_android_ui "https://github.com/yokeshwarb/qurb/blob/main/android/app/src/main/java/com/qurb/MainActivity.kt"
click node_android_bridge "https://github.com/yokeshwarb/qurb/blob/main/android/app/src/main/java/com/qurb/Qurb.kt"
click node_android_sync "https://github.com/yokeshwarb/qurb/blob/main/android/app/src/main/java/com/qurb/SyncWorker.kt"
click node_mobile_ffi "https://github.com/yokeshwarb/qurb/blob/main/crates/mobile-ffi/src/lib.rs"
click node_engine "https://github.com/yokeshwarb/qurb/blob/main/crates/engine/src/lib.rs"
click node_reconcile "https://github.com/yokeshwarb/qurb/blob/main/crates/sync/src/reconcile.rs"
click node_storage "https://github.com/yokeshwarb/qurb/blob/main/crates/storage/src/store.rs"
click node_watcher "https://github.com/yokeshwarb/qurb/blob/main/crates/watcher/src/watcher.rs"
click node_keys "https://github.com/yokeshwarb/qurb/blob/main/crates/keys/src/vault.rs"
click node_peer_client "https://github.com/yokeshwarb/qurb/blob/main/crates/peer/src/client.rs"
click node_peer_connect "https://github.com/yokeshwarb/qurb/blob/main/crates/peer/src/connect.rs"
click node_peer_server "https://github.com/yokeshwarb/qurb/blob/main/crates/peer/src/server.rs"
click node_signal_client "https://github.com/yokeshwarb/qurb/blob/main/crates/signal/src/client.rs"
click node_signal_server "https://github.com/yokeshwarb/qurb/blob/main/crates/signal/src/server.rs"
click node_relay "https://github.com/yokeshwarb/qurb/blob/main/crates/relay/src/server.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_desktop,node_desktop_commands,node_cli,node_android_ui,node_android_bridge,node_android_sync,node_mobile_ffi toneBlue
class node_engine,node_reconcile,node_storage,node_watcher,node_keys toneAmber
class node_peer_client,node_peer_connect,node_peer_server toneMint
class node_signal_client,node_signal_server,node_relay toneRose
class node_user toneIndigo
```

## Components

### User clients

- [Desktop window](https://github.com/yokeshwarb/qurb/blob/main/crates/desktop/src/main.rs): `crates/desktop/src/main.rs`
- [Desktop commands](https://github.com/yokeshwarb/qurb/blob/main/crates/desktop/src/commands.rs): `crates/desktop/src/commands.rs`
- [CLI and daemon](https://github.com/yokeshwarb/qurb/blob/main/crates/qurb/src/daemon.rs): `crates/qurb/src/daemon.rs`
- [Android app](https://github.com/yokeshwarb/qurb/blob/main/android/app/src/main/java/com/qurb/MainActivity.kt): `android/app/src/main/java/com/qurb/MainActivity.kt`
- [Android engine bridge](https://github.com/yokeshwarb/qurb/blob/main/android/app/src/main/java/com/qurb/Qurb.kt): `android/app/src/main/java/com/qurb/Qurb.kt`
- [Android sync worker](https://github.com/yokeshwarb/qurb/blob/main/android/app/src/main/java/com/qurb/SyncWorker.kt): `android/app/src/main/java/com/qurb/SyncWorker.kt`
- [Mobile FFI](https://github.com/yokeshwarb/qurb/blob/main/crates/mobile-ffi/src/lib.rs): `crates/mobile-ffi/src/lib.rs`

### Sync and storage

- [Sync engine](https://github.com/yokeshwarb/qurb/blob/main/crates/engine/src/lib.rs): `crates/engine/src/lib.rs`
- [Version reconciliation](https://github.com/yokeshwarb/qurb/blob/main/crates/sync/src/reconcile.rs): `crates/sync/src/reconcile.rs`
- [File store](https://github.com/yokeshwarb/qurb/blob/main/crates/storage/src/store.rs): `crates/storage/src/store.rs`
- [Filesystem watcher](https://github.com/yokeshwarb/qurb/blob/main/crates/watcher/src/watcher.rs): `crates/watcher/src/watcher.rs`
- [Key management](https://github.com/yokeshwarb/qurb/blob/main/crates/keys/src/vault.rs): `crates/keys/src/vault.rs`

### Device networking

- [Peer client](https://github.com/yokeshwarb/qurb/blob/main/crates/peer/src/client.rs): `crates/peer/src/client.rs`
- [Peer connection](https://github.com/yokeshwarb/qurb/blob/main/crates/peer/src/connect.rs): `crates/peer/src/connect.rs`
- [Peer server](https://github.com/yokeshwarb/qurb/blob/main/crates/peer/src/server.rs): `crates/peer/src/server.rs`

### Connection services

- [Rendezvous client](https://github.com/yokeshwarb/qurb/blob/main/crates/signal/src/client.rs): `crates/signal/src/client.rs`
- [Rendezvous service](https://github.com/yokeshwarb/qurb/blob/main/crates/signal/src/server.rs): `crates/signal/src/server.rs`
- [Opaque relay](https://github.com/yokeshwarb/qurb/blob/main/crates/relay/src/server.rs): `crates/relay/src/server.rs`

### Other components

- **Device owner**

## Connections

- Device owner → Desktop window: uses (evidence: `README.md`)
- Device owner → Android app: uses (evidence: `README.md`)
- Desktop window → Desktop commands: invokes (evidence: `crates/desktop/src/main.rs`)
- Desktop window → CLI and daemon: hosts daemon (evidence: `crates/desktop/src/main.rs`)
- Device owner → CLI and daemon: runs setup and sync (evidence: `README.md`)
- Android app → Android engine bridge: calls (evidence: `android/app/src/main/java/com/qurb/MainActivity.kt`)
- Android engine bridge → Mobile FFI: uses bindings (evidence: `android/app/src/main/java/com/qurb/Qurb.kt`)
- Android sync worker → Mobile FFI: runs sync
- CLI and daemon → Sync engine: runs sync engine
- Sync engine → File store: stores file data
- Sync engine → Version reconciliation: resolves versions
- Sync engine → Peer client: syncs with peers
- Sync engine → Peer server: serves peers
- Sync engine → Key management: uses device keys
- CLI and daemon → Filesystem watcher: tracks file changes
- Peer client → Peer connection: establishes connection (evidence: `crates/peer/src/client.rs`)
- Peer client → File store: fetches content (evidence: `crates/peer/src/client.rs`)
- Peer server → File store: answers requests (evidence: `crates/peer/src/server.rs`)
- Peer connection → Rendezvous client: discovers peers
- Rendezvous client → Rendezvous service: exchanges rendezvous messages (evidence: `crates/signal/src/client.rs`)
- Rendezvous service → Peer connection: introduces devices
- Peer connection → Opaque relay: falls back to relay
