How deadlium/vault-note works
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: VaultSessionManager.ts Session manager · useVaultStore.ts Item state · App.tsx App navigation · setup.tsx Setup and unlock
Components 25
Mobile experience
- App navigation
src/App.tsx - Setup and unlock
src/app/(auth)/setup.tsx - Vault screens
src/app/(vault)/item/edit.tsx
Vault lifecycle
- Session manager
src/core/session/VaultSessionManager.ts - Session state
src/core/session/useSessionStore.ts - Auto-lock policy
src/hooks/useAutoLock.ts
Encrypted item storage
- Item state
src/features/vault/store/useVaultStore.ts - Vault repository
src/features/vault/repository/vaultRepository.ts - Item encryption
src/features/vault/services/vaultEncryptionService.ts - Encrypted SQLite
src/core/database/connection.ts
Vault tools
- Search screen
src/features/search/components/SearchScreen.tsx - Ephemeral search
src/features/search/useVaultSearch.ts - RAM search index
src/features/search/searchIndex.ts - Backup engine
src/features/backup/backupEngine.ts - Backup screen
src/features/backup/components/BackupScreen.tsx - TOTP authenticator
src/features/totp/totpEngine.ts - OTP URI parser
src/features/totp/parser/otpauthParser.ts - Security audit
src/features/security-center/auditEngine.ts - Favorites
src/features/favorites/components/FavoritesScreen.tsx - Settings
src/features/settings/index.ts
Security services
- Key derivation
src/core/crypto/kdf.ts - Secure key storage
src/core/storage/enclave.ts - Biometric auth
src/core/biometric/biometricService.ts - Clipboard sanitizer
src/core/clipboard/clipboardManager.ts
Other components
- Vault owner
Connections 24
- Vault owner → App navigation: uses
README.md - App navigation → Setup and unlock: routes to
src/App.tsx - App navigation → Vault screens: routes to
src/App.tsx - Setup and unlock → Session manager: manages session
- Session manager → Session state: updates state
src/core/session/VaultSessionManager.ts - Session manager → Secure key storage: checks initialization
src/core/session/VaultSessionManager.ts - Auto-lock policy → Session manager: locks vault
src/hooks/useAutoLock.ts - Vault screens → Item state: reads and writes
src/app/(vault)/item/edit.tsx - Item state → Vault repository: persists items
src/features/vault/store/useVaultStore.ts - Vault repository → Item encryption: encrypts and decrypts
src/features/vault/repository/vaultRepository.ts - Vault repository → Encrypted SQLite: reads and writes
src/features/vault/repository/vaultRepository.ts - Setup and unlock → Key derivation: derives keys
- Session state → Secure key storage: stores preferences
src/core/session/useSessionStore.ts - Search screen → Ephemeral search: queries
src/features/search/components/SearchScreen.tsx - Ephemeral search → Item state: reads items
src/features/search/useVaultSearch.ts - Ephemeral search → RAM search index: searches RAM index
src/features/search/useVaultSearch.ts - Backup screen → Backup engine: imports and exports
- Backup engine → Key derivation: derives backup key
src/features/backup/backupEngine.ts - TOTP authenticator → OTP URI parser: parses OTP URI
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