# amad3v/arsu architecture

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

- Interactive diagram: https://gitdiagram.com/amad3v/arsu
- Repository: https://github.com/amad3v/arsu

## Overview

Arsu is an offline authenticator for Linux and Android. The user creates or unlocks an encrypted vault, adds accounts, and uses generated TOTP/HOTP codes; the frontend reaches Rust through typed Tauri commands. Optional branches cover import/export, diagnostics, and direct Bluetooth or encrypted-file device sync. The graph preserves documented capabilities, but several backend implementations are unsampled, so their internal call paths are not inferred.

Main entry points: [`crates/cmd/src/commands.rs`](https://github.com/amad3v/arsu/blob/main/crates/cmd/src/commands.rs) (Command handlers), [`src/App.tsx`](https://github.com/amad3v/arsu/blob/main/src/App.tsx) (App flow), [`crates/cmd/src/bluetooth.rs`](https://github.com/amad3v/arsu/blob/main/crates/cmd/src/bluetooth.rs) (Bluetooth links), [`crates/cmd/src/diagnostics/mod.rs`](https://github.com/amad3v/arsu/blob/main/crates/cmd/src/diagnostics/mod.rs) (Diagnostic reports)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["User interface"]
  node_app["App flow<br/>[App.tsx]"]
  node_entry_ui["Account entry"]
  node_dashboard["Code dashboard"]
  node_sync_ui["Sync screens<br/>[index.tsx]"]
  node_api["Typed IPC<br/>[index.ts]"]
end

subgraph group_backend["Command backend"]
  node_tauri["Tauri shell<br/>[lib.rs]"]
  node_commands["Command handlers<br/>[commands.rs]"]
  node_state["App state"]
end

subgraph group_vault["Vault and codes"]
  node_vault_file[("Encrypted vault<br/>[vault.rs]")]
  node_vault_format["Vault payload<br/>[payload.rs]"]
  node_crypto["Vault crypto<br/>[lib.rs]"]
  node_otp["OTP codes<br/>[lib.rs]"]
  node_qr["QR and URI"]
  node_interop["Backup formats"]
end

subgraph group_sync["Device sync"]
  node_sync_protocol["Sync protocol<br/>[session.rs]"]
  node_sync_file["Encrypted sync file<br/>[file.rs]"]
  node_bluetooth["Bluetooth links<br/>[bluetooth.rs]"]
  node_ble_linux["Linux BLE"]
  node_ble_android["Android BLE<br/>[lib.rs]"]
end

subgraph group_support["Platform and diagnostics"]
  node_diagnostics["Diagnostic reports<br/>[mod.rs]"]
  node_diag_events["Diagnostic events<br/>[event.rs]"]
  node_diag_redact["Sensitive-data redaction<br/>[redact.rs]"]
  node_diag_files[("Rotated log files<br/>[files.rs]")]
  node_biometric["Biometric access<br/>[lib.rs]"]
  node_clipboard["Secure clipboard<br/>[clipboard.rs]"]
end

node_user(("User"))

node_user -->|"uses"| node_app
node_app -.->|"requests backend"| node_api
node_app -->|"shows unlocked view"| node_dashboard
node_app -.->|"opens account flow"| node_entry_ui
node_user -->|"adds accounts"| node_entry_ui
node_user -->|"starts pairing or sync"| node_sync_ui
node_api -->|"invokes"| node_commands
node_tauri -->|"registers handlers"| node_commands
node_commands -->|"delegates state work"| node_state
node_state -.->|"reads and saves"| node_vault_file
node_vault_file -.->|"stores payload"| node_vault_format
node_vault_format -.->|"encrypted by"| node_crypto
node_dashboard -->|"shows generated codes"| node_otp
node_entry_ui -.->|"parses account QR"| node_qr
node_commands -->|"imports and exports backups"| node_interop
node_sync_ui -.->|"requests sync actions"| node_api
node_commands -.->|"runs sync sessions"| node_sync_protocol
node_commands -.->|"handles sync files"| node_sync_file
node_commands -->|"starts Bluetooth sync"| node_bluetooth
node_bluetooth -.->|"uses platform transport"| node_ble_linux
node_bluetooth -.->|"uses platform transport"| node_ble_android
node_commands -->|"prepares reports"| node_diagnostics
node_diagnostics -->|"records events"| node_diag_events
node_diag_events -->|"redacts sensitive data"| node_diag_redact
node_diagnostics -->|"writes and reads logs"| node_diag_files
node_commands -->|"supports biometric export"| node_biometric
node_commands -.->|"handles copied codes"| node_clipboard

click node_app "https://github.com/amad3v/arsu/blob/main/src/App.tsx"
click node_entry_ui "https://github.com/amad3v/arsu/tree/main/src/components/add-entry-dialog"
click node_dashboard "https://github.com/amad3v/arsu/tree/main/src/components/dashboard"
click node_sync_ui "https://github.com/amad3v/arsu/blob/main/src/components/sync-dialog/index.tsx"
click node_api "https://github.com/amad3v/arsu/blob/main/src/api/index.ts"
click node_tauri "https://github.com/amad3v/arsu/blob/main/src-tauri/src/lib.rs"
click node_commands "https://github.com/amad3v/arsu/blob/main/crates/cmd/src/commands.rs"
click node_state "https://github.com/amad3v/arsu/tree/main/crates/cmd/src/state"
click node_vault_file "https://github.com/amad3v/arsu/blob/main/crates/storage/src/vault.rs"
click node_vault_format "https://github.com/amad3v/arsu/blob/main/crates/vault-core/src/payload.rs"
click node_crypto "https://github.com/amad3v/arsu/blob/main/crates/crypto/src/lib.rs"
click node_otp "https://github.com/amad3v/arsu/blob/main/crates/otp/src/lib.rs"
click node_qr "https://github.com/amad3v/arsu/tree/main/crates/qr/src"
click node_interop "https://github.com/amad3v/arsu/tree/main/crates/interop/src"
click node_sync_protocol "https://github.com/amad3v/arsu/blob/main/crates/vault-sync/src/session.rs"
click node_sync_file "https://github.com/amad3v/arsu/blob/main/crates/vault-sync/src/file.rs"
click node_bluetooth "https://github.com/amad3v/arsu/blob/main/crates/cmd/src/bluetooth.rs"
click node_ble_linux "https://github.com/amad3v/arsu/tree/main/crates/ble-linux/src"
click node_ble_android "https://github.com/amad3v/arsu/blob/main/crates/ble-android/src/lib.rs"
click node_diagnostics "https://github.com/amad3v/arsu/blob/main/crates/cmd/src/diagnostics/mod.rs"
click node_diag_events "https://github.com/amad3v/arsu/blob/main/crates/cmd/src/diagnostics/event.rs"
click node_diag_redact "https://github.com/amad3v/arsu/blob/main/crates/cmd/src/diagnostics/redact.rs"
click node_diag_files "https://github.com/amad3v/arsu/blob/main/crates/cmd/src/diagnostics/files.rs"
click node_biometric "https://github.com/amad3v/arsu/blob/main/crates/biometric/src/lib.rs"
click node_clipboard "https://github.com/amad3v/arsu/blob/main/crates/cmd/src/clipboard.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_app,node_entry_ui,node_dashboard,node_sync_ui,node_api,node_user toneBlue
class node_tauri,node_commands,node_state toneAmber
class node_vault_file,node_vault_format,node_crypto,node_otp,node_qr,node_interop toneMint
class node_sync_protocol,node_sync_file,node_bluetooth,node_ble_linux,node_ble_android toneRose
class node_diagnostics,node_diag_events,node_diag_redact,node_diag_files,node_biometric,node_clipboard toneIndigo
```

## Components

### User interface

- [App flow](https://github.com/amad3v/arsu/blob/main/src/App.tsx): `src/App.tsx`
- [Account entry](https://github.com/amad3v/arsu/tree/main/src/components/add-entry-dialog): `src/components/add-entry-dialog`
- [Code dashboard](https://github.com/amad3v/arsu/tree/main/src/components/dashboard): `src/components/dashboard`
- [Sync screens](https://github.com/amad3v/arsu/blob/main/src/components/sync-dialog/index.tsx): `src/components/sync-dialog/index.tsx`
- [Typed IPC](https://github.com/amad3v/arsu/blob/main/src/api/index.ts): `src/api/index.ts`

### Command backend

- [Tauri shell](https://github.com/amad3v/arsu/blob/main/src-tauri/src/lib.rs): `src-tauri/src/lib.rs`
- [Command handlers](https://github.com/amad3v/arsu/blob/main/crates/cmd/src/commands.rs): `crates/cmd/src/commands.rs`
- [App state](https://github.com/amad3v/arsu/tree/main/crates/cmd/src/state): `crates/cmd/src/state`

### Vault and codes

- [Encrypted vault](https://github.com/amad3v/arsu/blob/main/crates/storage/src/vault.rs): `crates/storage/src/vault.rs`
- [Vault payload](https://github.com/amad3v/arsu/blob/main/crates/vault-core/src/payload.rs): `crates/vault-core/src/payload.rs`
- [Vault crypto](https://github.com/amad3v/arsu/blob/main/crates/crypto/src/lib.rs): `crates/crypto/src/lib.rs`
- [OTP codes](https://github.com/amad3v/arsu/blob/main/crates/otp/src/lib.rs): `crates/otp/src/lib.rs`
- [QR and URI](https://github.com/amad3v/arsu/tree/main/crates/qr/src): `crates/qr/src`
- [Backup formats](https://github.com/amad3v/arsu/tree/main/crates/interop/src): `crates/interop/src`

### Device sync

- [Sync protocol](https://github.com/amad3v/arsu/blob/main/crates/vault-sync/src/session.rs): `crates/vault-sync/src/session.rs`
- [Encrypted sync file](https://github.com/amad3v/arsu/blob/main/crates/vault-sync/src/file.rs): `crates/vault-sync/src/file.rs`
- [Bluetooth links](https://github.com/amad3v/arsu/blob/main/crates/cmd/src/bluetooth.rs): `crates/cmd/src/bluetooth.rs`
- [Linux BLE](https://github.com/amad3v/arsu/tree/main/crates/ble-linux/src): `crates/ble-linux/src`
- [Android BLE](https://github.com/amad3v/arsu/blob/main/crates/ble-android/src/lib.rs): `crates/ble-android/src/lib.rs`

### Platform and diagnostics

- [Diagnostic reports](https://github.com/amad3v/arsu/blob/main/crates/cmd/src/diagnostics/mod.rs): `crates/cmd/src/diagnostics/mod.rs`
- [Diagnostic events](https://github.com/amad3v/arsu/blob/main/crates/cmd/src/diagnostics/event.rs): `crates/cmd/src/diagnostics/event.rs`
- [Sensitive-data redaction](https://github.com/amad3v/arsu/blob/main/crates/cmd/src/diagnostics/redact.rs): `crates/cmd/src/diagnostics/redact.rs`
- [Rotated log files](https://github.com/amad3v/arsu/blob/main/crates/cmd/src/diagnostics/files.rs): `crates/cmd/src/diagnostics/files.rs`
- [Biometric access](https://github.com/amad3v/arsu/blob/main/crates/biometric/src/lib.rs): `crates/biometric/src/lib.rs`
- [Secure clipboard](https://github.com/amad3v/arsu/blob/main/crates/cmd/src/clipboard.rs): `crates/cmd/src/clipboard.rs`

### Other components

- **User**

## Connections

- User → App flow: uses (evidence: `README.md`)
- App flow → Typed IPC: requests backend
- App flow → Code dashboard: shows unlocked view (evidence: `src/App.tsx`)
- App flow → Account entry: opens account flow
- User → Account entry: adds accounts (evidence: `README.md`)
- User → Sync screens: starts pairing or sync (evidence: `README.md`)
- Typed IPC → Command handlers: invokes (evidence: `src/api/index.ts`)
- Tauri shell → Command handlers: registers handlers (evidence: `src-tauri/src/lib.rs`)
- Command handlers → App state: delegates state work (evidence: `crates/cmd/src/commands.rs`)
- App state → Encrypted vault: reads and saves
- Encrypted vault → Vault payload: stores payload
- Vault payload → Vault crypto: encrypted by
- Code dashboard → OTP codes: shows generated codes (evidence: `README.md`)
- Account entry → QR and URI: parses account QR
- Command handlers → Backup formats: imports and exports backups (evidence: `README.md`)
- Sync screens → Typed IPC: requests sync actions
- Command handlers → Sync protocol: runs sync sessions
- Command handlers → Encrypted sync file: handles sync files
- Command handlers → Bluetooth links: starts Bluetooth sync (evidence: `crates/cmd/src/commands.rs`)
- Bluetooth links → Linux BLE: uses platform transport
- Bluetooth links → Android BLE: uses platform transport
- Command handlers → Diagnostic reports: prepares reports (evidence: `crates/cmd/src/commands.rs`)
- Diagnostic reports → Diagnostic events: records events (evidence: `crates/cmd/src/diagnostics/mod.rs`)
- Diagnostic events → Sensitive-data redaction: redacts sensitive data (evidence: `crates/cmd/src/diagnostics/event.rs`)
- Diagnostic reports → Rotated log files: writes and reads logs (evidence: `crates/cmd/src/diagnostics/mod.rs`)
- Command handlers → Biometric access: supports biometric export (evidence: `crates/cmd/src/commands.rs`)
- Command handlers → Secure clipboard: handles copied codes
