# rhyvex-the-dev/xenonypt architecture

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

- Interactive diagram: https://gitdiagram.com/rhyvex-the-dev/xenonypt
- Repository: https://github.com/rhyvex-the-dev/xenonypt

## Overview

Xenonypt is a cross-platform encrypted file-vault app. The user creates or unlocks a vault, manages encrypted files, and can extract or stream their contents; the Flutter UI communicates with the Rust vault core through flutter_rust_bridge. The graph preserves documented file-management, loose-file, streaming, obfuscation, and hardware-biometric capabilities. Source excerpts show the Rust API-to-vault calls and filesystem operations; Flutter UI behavior and biometric implementation details are documented only at a high level, so those links are marked unverified.

Main entry points: [`lib/main.dart`](https://github.com/rhyvex-the-dev/xenonypt/blob/main/lib/main.dart) (Vault UI), [`lib/src/vault.rs`](https://github.com/rhyvex-the-dev/xenonypt/blob/main/lib/src/vault.rs) (File management), [`lib/src/rust`](https://github.com/rhyvex-the-dev/xenonypt/tree/main/lib/src/rust) (Dart bindings), [`lib/src/frb_generated.rs`](https://github.com/rhyvex-the-dev/xenonypt/blob/main/lib/src/frb_generated.rs) (Generated bridge)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Flutter app"]
  node_ui["Vault UI<br/>[main.dart]"]
end

subgraph group_bridge["Rust bridge"]
  node_dart_bindings["Dart bindings"]
  node_rust_bridge["Generated bridge<br/>[frb_generated.rs]"]
  node_api["Vault API<br/>[api.rs]"]
end

subgraph group_vault["Vault operations"]
  node_vault_core["Vault core<br/>[vault.rs]"]
  node_file_ops["File management<br/>[vault.rs]"]
  node_metadata["Encrypted metadata<br/>[vault.rs]"]
  node_streaming["Chunk streaming<br/>[vault.rs]"]
  node_vault_storage[("Vault files")]
end

subgraph group_security["Device security"]
  node_platform_auth["Hardware biometrics"]
  node_ios_keychain["iOS Keychain"]
end

node_user(("Vault user"))
node_device_auth(("OS authenticator"))

node_user -.->|"uses"| node_ui
node_ui -.->|"requests vault actions"| node_dart_bindings
node_dart_bindings -.->|"invokes"| node_rust_bridge
node_rust_bridge -->|"dispatches calls"| node_api
node_api -->|"delegates to"| node_vault_core
node_vault_core -.->|"performs"| node_file_ops
node_file_ops -->|"reads and writes"| node_vault_storage
node_file_ops -->|"updates"| node_metadata
node_streaming -.->|"reads chunks"| node_vault_storage
node_ui -.->|"requests biometric unlock"| node_platform_auth
node_platform_auth -.->|"authenticates with"| node_device_auth
node_ios_keychain -.->|"uses biometrics"| node_device_auth

click node_ui "https://github.com/rhyvex-the-dev/xenonypt/blob/main/lib/main.dart"
click node_dart_bindings "https://github.com/rhyvex-the-dev/xenonypt/tree/main/lib/src/rust"
click node_rust_bridge "https://github.com/rhyvex-the-dev/xenonypt/blob/main/lib/src/frb_generated.rs"
click node_api "https://github.com/rhyvex-the-dev/xenonypt/blob/main/lib/src/api.rs"
click node_vault_core "https://github.com/rhyvex-the-dev/xenonypt/blob/main/lib/src/vault.rs"
click node_file_ops "https://github.com/rhyvex-the-dev/xenonypt/blob/main/lib/src/vault.rs"
click node_metadata "https://github.com/rhyvex-the-dev/xenonypt/blob/main/lib/src/vault.rs"
click node_streaming "https://github.com/rhyvex-the-dev/xenonypt/blob/main/lib/src/vault.rs"
click node_platform_auth "https://github.com/rhyvex-the-dev/xenonypt/tree/main/android/app/src/main"
click node_ios_keychain "https://github.com/rhyvex-the-dev/xenonypt/tree/main/ios/Runner"

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_ui,node_user toneBlue
class node_dart_bindings,node_rust_bridge,node_api toneAmber
class node_vault_core,node_file_ops,node_metadata,node_streaming,node_vault_storage toneMint
class node_platform_auth,node_ios_keychain toneRose
class node_device_auth toneIndigo
```

## Components

### Flutter app

- [Vault UI](https://github.com/rhyvex-the-dev/xenonypt/blob/main/lib/main.dart): `lib/main.dart`

### Rust bridge

- [Dart bindings](https://github.com/rhyvex-the-dev/xenonypt/tree/main/lib/src/rust): `lib/src/rust`
- [Generated bridge](https://github.com/rhyvex-the-dev/xenonypt/blob/main/lib/src/frb_generated.rs): `lib/src/frb_generated.rs`
- [Vault API](https://github.com/rhyvex-the-dev/xenonypt/blob/main/lib/src/api.rs): `lib/src/api.rs`

### Vault operations

- [Vault core](https://github.com/rhyvex-the-dev/xenonypt/blob/main/lib/src/vault.rs): `lib/src/vault.rs`
- [File management](https://github.com/rhyvex-the-dev/xenonypt/blob/main/lib/src/vault.rs): `lib/src/vault.rs`
- [Encrypted metadata](https://github.com/rhyvex-the-dev/xenonypt/blob/main/lib/src/vault.rs): `lib/src/vault.rs`
- [Chunk streaming](https://github.com/rhyvex-the-dev/xenonypt/blob/main/lib/src/vault.rs): `lib/src/vault.rs`
- **Vault files**

### Device security

- [Hardware biometrics](https://github.com/rhyvex-the-dev/xenonypt/tree/main/android/app/src/main): `android/app/src/main`
- [iOS Keychain](https://github.com/rhyvex-the-dev/xenonypt/tree/main/ios/Runner): `ios/Runner`

### Other components

- **Vault user**
- **OS authenticator**

## Connections

- Vault user → Vault UI: uses
- Vault UI → Dart bindings: requests vault actions
- Dart bindings → Generated bridge: invokes
- Generated bridge → Vault API: dispatches calls (evidence: `lib/src/frb_generated.rs`)
- Vault API → Vault core: delegates to (evidence: `lib/src/api.rs`)
- Vault core → File management: performs (evidence: `lib/src/vault.rs`)
- File management → Vault files: reads and writes (evidence: `lib/src/vault.rs`)
- File management → Encrypted metadata: updates (evidence: `lib/src/vault.rs`)
- Chunk streaming → Vault files: reads chunks
- Vault UI → Hardware biometrics: requests biometric unlock
- Hardware biometrics → OS authenticator: authenticates with
- iOS Keychain → OS authenticator: uses biometrics
