# deadlium/vault-note architecture

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

- Interactive diagram: https://gitdiagram.com/deadlium/vault-note
- Repository: https://github.com/deadlium/vault-note

## Overview

VaultNote is an offline-first mobile secrets vault. The main workflow is local setup or unlock, then viewing and editing encrypted vault items, with search and specialized tools operating on the unlocked vault. The graph preserves documented branches for TOTP, backups, security audits, favorites, and settings. Evidence is limited to the README, SOURCE INDEX references, and shown excerpts; unsampled implementation details and some screen-to-feature wiring are therefore omitted or left unconnected.

Main entry points: [`src/core/session/VaultSessionManager.ts`](https://github.com/deadlium/vault-note/blob/master/src/core/session/VaultSessionManager.ts) (Session manager), [`src/features/vault/store/useVaultStore.ts`](https://github.com/deadlium/vault-note/blob/master/src/features/vault/store/useVaultStore.ts) (Item state), [`src/App.tsx`](https://github.com/deadlium/vault-note/blob/master/src/App.tsx) (App navigation), [`src/app/(auth)/setup.tsx`](https://github.com/deadlium/vault-note/blob/master/src/app/(auth)/setup.tsx) (Setup and unlock)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Mobile experience"]
  node_application["App navigation<br/>[App.tsx]"]
  node_setup["Setup and unlock<br/>[setup.tsx]"]
  node_vaultscreens["Vault screens<br/>[edit.tsx]"]
end

subgraph group_lifecycle["Vault lifecycle"]
  node_sessionmanager["Session manager"]
  node_sessionstore["Session state<br/>[useSessionStore.ts]"]
  node_autolock["Auto-lock policy<br/>[useAutoLock.ts]"]
end

subgraph group_items["Encrypted item storage"]
  node_itemstore["Item state<br/>[useVaultStore.ts]"]
  node_vaultrepo["Vault repository<br/>[vaultRepository.ts]"]
  node_encryption["Item encryption"]
  node_database[("Encrypted SQLite<br/>[connection.ts]")]
end

subgraph group_tools["Vault tools"]
  node_searchscreen["Search screen<br/>[SearchScreen.tsx]"]
  node_searchhook["Ephemeral search<br/>[useVaultSearch.ts]"]
  node_searchindex["RAM search index<br/>[searchIndex.ts]"]
  node_backup["Backup engine<br/>[backupEngine.ts]"]
  node_backupui["Backup screen<br/>[BackupScreen.tsx]"]
  node_totp["TOTP authenticator<br/>[totpEngine.ts]"]
  node_totpparser["OTP URI parser<br/>[otpauthParser.ts]"]
  node_audit["Security audit<br/>[auditEngine.ts]"]
  node_favorites["Favorites"]
  node_settings["Settings<br/>[index.ts]"]
end

subgraph group_security["Security services"]
  node_crypto["Key derivation<br/>[kdf.ts]"]
  node_enclave["Secure key storage<br/>[enclave.ts]"]
  node_biometric["Biometric auth"]
  node_clipboard["Clipboard sanitizer"]
end

node_user(("Vault owner"))

node_user -->|"uses"| node_application
node_application -->|"routes to"| node_setup
node_application -->|"routes to"| node_vaultscreens
node_setup -.->|"manages session"| node_sessionmanager
node_sessionmanager -->|"updates state"| node_sessionstore
node_sessionmanager -->|"checks initialization"| node_enclave
node_autolock -->|"locks vault"| node_sessionmanager
node_vaultscreens -->|"reads and writes"| node_itemstore
node_itemstore -->|"persists items"| node_vaultrepo
node_vaultrepo -->|"encrypts and decrypts"| node_encryption
node_vaultrepo -->|"reads and writes"| node_database
node_setup -.->|"derives keys"| node_crypto
node_sessionstore -->|"stores preferences"| node_enclave
node_searchscreen -->|"queries"| node_searchhook
node_searchhook -->|"reads items"| node_itemstore
node_searchhook -->|"searches RAM index"| node_searchindex
node_backupui -.->|"imports and exports"| node_backup
node_backup -->|"derives backup key"| node_crypto
node_totp -->|"parses OTP URI"| node_totpparser
node_audit -.->|"assesses credentials"| node_itemstore
node_favorites -.->|"uses favorite items"| node_itemstore
node_settings -.->|"configures vault"| node_sessionmanager
node_biometric -.->|"uses secure keys"| node_enclave
node_clipboard -.->|"sanitizes copied secrets"| node_vaultscreens

click node_application "https://github.com/deadlium/vault-note/blob/master/src/App.tsx"
click node_setup "https://github.com/deadlium/vault-note/blob/master/src/app/(auth)/setup.tsx"
click node_vaultscreens "https://github.com/deadlium/vault-note/blob/master/src/app/(vault)/item/edit.tsx"
click node_sessionmanager "https://github.com/deadlium/vault-note/blob/master/src/core/session/VaultSessionManager.ts"
click node_sessionstore "https://github.com/deadlium/vault-note/blob/master/src/core/session/useSessionStore.ts"
click node_autolock "https://github.com/deadlium/vault-note/blob/master/src/hooks/useAutoLock.ts"
click node_itemstore "https://github.com/deadlium/vault-note/blob/master/src/features/vault/store/useVaultStore.ts"
click node_vaultrepo "https://github.com/deadlium/vault-note/blob/master/src/features/vault/repository/vaultRepository.ts"
click node_encryption "https://github.com/deadlium/vault-note/blob/master/src/features/vault/services/vaultEncryptionService.ts"
click node_database "https://github.com/deadlium/vault-note/blob/master/src/core/database/connection.ts"
click node_crypto "https://github.com/deadlium/vault-note/blob/master/src/core/crypto/kdf.ts"
click node_enclave "https://github.com/deadlium/vault-note/blob/master/src/core/storage/enclave.ts"
click node_biometric "https://github.com/deadlium/vault-note/blob/master/src/core/biometric/biometricService.ts"
click node_clipboard "https://github.com/deadlium/vault-note/blob/master/src/core/clipboard/clipboardManager.ts"
click node_searchscreen "https://github.com/deadlium/vault-note/blob/master/src/features/search/components/SearchScreen.tsx"
click node_searchhook "https://github.com/deadlium/vault-note/blob/master/src/features/search/useVaultSearch.ts"
click node_searchindex "https://github.com/deadlium/vault-note/blob/master/src/features/search/searchIndex.ts"
click node_backup "https://github.com/deadlium/vault-note/blob/master/src/features/backup/backupEngine.ts"
click node_backupui "https://github.com/deadlium/vault-note/blob/master/src/features/backup/components/BackupScreen.tsx"
click node_totp "https://github.com/deadlium/vault-note/blob/master/src/features/totp/totpEngine.ts"
click node_totpparser "https://github.com/deadlium/vault-note/blob/master/src/features/totp/parser/otpauthParser.ts"
click node_audit "https://github.com/deadlium/vault-note/blob/master/src/features/security-center/auditEngine.ts"
click node_favorites "https://github.com/deadlium/vault-note/blob/master/src/features/favorites/components/FavoritesScreen.tsx"
click node_settings "https://github.com/deadlium/vault-note/blob/master/src/features/settings/index.ts"

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_application,node_setup,node_vaultscreens toneBlue
class node_sessionmanager,node_sessionstore,node_autolock toneAmber
class node_itemstore,node_vaultrepo,node_encryption,node_database toneMint
class node_searchscreen,node_searchhook,node_searchindex,node_backup,node_backupui,node_totp,node_totpparser,node_audit,node_favorites,node_settings toneRose
class node_crypto,node_enclave,node_biometric,node_clipboard,node_user toneIndigo
```

## Components

### Mobile experience

- [App navigation](https://github.com/deadlium/vault-note/blob/master/src/App.tsx): `src/App.tsx`
- [Setup and unlock](https://github.com/deadlium/vault-note/blob/master/src/app/(auth)/setup.tsx): `src/app/(auth)/setup.tsx`
- [Vault screens](https://github.com/deadlium/vault-note/blob/master/src/app/(vault)/item/edit.tsx): `src/app/(vault)/item/edit.tsx`

### Vault lifecycle

- [Session manager](https://github.com/deadlium/vault-note/blob/master/src/core/session/VaultSessionManager.ts): `src/core/session/VaultSessionManager.ts`
- [Session state](https://github.com/deadlium/vault-note/blob/master/src/core/session/useSessionStore.ts): `src/core/session/useSessionStore.ts`
- [Auto-lock policy](https://github.com/deadlium/vault-note/blob/master/src/hooks/useAutoLock.ts): `src/hooks/useAutoLock.ts`

### Encrypted item storage

- [Item state](https://github.com/deadlium/vault-note/blob/master/src/features/vault/store/useVaultStore.ts): `src/features/vault/store/useVaultStore.ts`
- [Vault repository](https://github.com/deadlium/vault-note/blob/master/src/features/vault/repository/vaultRepository.ts): `src/features/vault/repository/vaultRepository.ts`
- [Item encryption](https://github.com/deadlium/vault-note/blob/master/src/features/vault/services/vaultEncryptionService.ts): `src/features/vault/services/vaultEncryptionService.ts`
- [Encrypted SQLite](https://github.com/deadlium/vault-note/blob/master/src/core/database/connection.ts): `src/core/database/connection.ts`

### Vault tools

- [Search screen](https://github.com/deadlium/vault-note/blob/master/src/features/search/components/SearchScreen.tsx): `src/features/search/components/SearchScreen.tsx`
- [Ephemeral search](https://github.com/deadlium/vault-note/blob/master/src/features/search/useVaultSearch.ts): `src/features/search/useVaultSearch.ts`
- [RAM search index](https://github.com/deadlium/vault-note/blob/master/src/features/search/searchIndex.ts): `src/features/search/searchIndex.ts`
- [Backup engine](https://github.com/deadlium/vault-note/blob/master/src/features/backup/backupEngine.ts): `src/features/backup/backupEngine.ts`
- [Backup screen](https://github.com/deadlium/vault-note/blob/master/src/features/backup/components/BackupScreen.tsx): `src/features/backup/components/BackupScreen.tsx`
- [TOTP authenticator](https://github.com/deadlium/vault-note/blob/master/src/features/totp/totpEngine.ts): `src/features/totp/totpEngine.ts`
- [OTP URI parser](https://github.com/deadlium/vault-note/blob/master/src/features/totp/parser/otpauthParser.ts): `src/features/totp/parser/otpauthParser.ts`
- [Security audit](https://github.com/deadlium/vault-note/blob/master/src/features/security-center/auditEngine.ts): `src/features/security-center/auditEngine.ts`
- [Favorites](https://github.com/deadlium/vault-note/blob/master/src/features/favorites/components/FavoritesScreen.tsx): `src/features/favorites/components/FavoritesScreen.tsx`
- [Settings](https://github.com/deadlium/vault-note/blob/master/src/features/settings/index.ts): `src/features/settings/index.ts`

### Security services

- [Key derivation](https://github.com/deadlium/vault-note/blob/master/src/core/crypto/kdf.ts): `src/core/crypto/kdf.ts`
- [Secure key storage](https://github.com/deadlium/vault-note/blob/master/src/core/storage/enclave.ts): `src/core/storage/enclave.ts`
- [Biometric auth](https://github.com/deadlium/vault-note/blob/master/src/core/biometric/biometricService.ts): `src/core/biometric/biometricService.ts`
- [Clipboard sanitizer](https://github.com/deadlium/vault-note/blob/master/src/core/clipboard/clipboardManager.ts): `src/core/clipboard/clipboardManager.ts`

### Other components

- **Vault owner**

## Connections

- Vault owner → App navigation: uses (evidence: `README.md`)
- App navigation → Setup and unlock: routes to (evidence: `src/App.tsx`)
- App navigation → Vault screens: routes to (evidence: `src/App.tsx`)
- Setup and unlock → Session manager: manages session
- Session manager → Session state: updates state (evidence: `src/core/session/VaultSessionManager.ts`)
- Session manager → Secure key storage: checks initialization (evidence: `src/core/session/VaultSessionManager.ts`)
- Auto-lock policy → Session manager: locks vault (evidence: `src/hooks/useAutoLock.ts`)
- Vault screens → Item state: reads and writes (evidence: `src/app/(vault)/item/edit.tsx`)
- Item state → Vault repository: persists items (evidence: `src/features/vault/store/useVaultStore.ts`)
- Vault repository → Item encryption: encrypts and decrypts (evidence: `src/features/vault/repository/vaultRepository.ts`)
- Vault repository → Encrypted SQLite: reads and writes (evidence: `src/features/vault/repository/vaultRepository.ts`)
- Setup and unlock → Key derivation: derives keys
- Session state → Secure key storage: stores preferences (evidence: `src/core/session/useSessionStore.ts`)
- Search screen → Ephemeral search: queries (evidence: `src/features/search/components/SearchScreen.tsx`)
- Ephemeral search → Item state: reads items (evidence: `src/features/search/useVaultSearch.ts`)
- Ephemeral search → RAM search index: searches RAM index (evidence: `src/features/search/useVaultSearch.ts`)
- Backup screen → Backup engine: imports and exports
- Backup engine → Key derivation: derives backup key (evidence: `src/features/backup/backupEngine.ts`)
- TOTP authenticator → OTP URI parser: parses OTP URI (evidence: `src/features/totp/totpEngine.ts`)
- Security audit → Item state: assesses credentials
- Favorites → Item state: uses favorite items
- Settings → Session manager: configures vault
- Biometric auth → Secure key storage: uses secure keys
- Clipboard sanitizer → Vault screens: sanitizes copied secrets
