How acevflow/lockwell works
lockwell is a local-only desktop password and encrypted-file vault. Users create or restore a vault, unlock it, manage password entries and files, make or restore encrypted backups, and lock the vault; the React interface invokes a Rust/Tauri core that owns cryptography and local storage. The graph preserves the documented security capabilities. Relationships involving unsampled command and vault implementations are shown only where the README or sampled registration/API code supports them; no network service is modeled.
Main entry points: lib.rs Command registration · session.rs Vault session · client.ts Tauri API client · App.tsx App flow
Components 28
Desktop interface
- App flow
src/App.tsx - Setup and unlock
src/screens/SetupScreen.tsx - Vault workspace
src/screens/VaultScreen.tsx - File management UI
src/screens/FilesTab.tsx - Password entry UI
src/components/EntryForm.tsx - Backup UI
src/components/RestoreBackupForm.tsx
Tauri command bridge
- Tauri API client
src/api/client.ts - Vault API
src/api/vault.ts - Security API
src/api/security.ts - Entry API
src/api/entries.ts - File API
src/api/files.ts - Backup API
src/api/backup.ts - Command registration
src-tauri/src/lib.rs - Vault commands
src-tauri/src/commands/vault.rs - Entry commands
src-tauri/src/commands/entries.rs - File commands
src-tauri/src/commands/files.rs - Security commands
src-tauri/src/commands/security.rs - Backup commands
src-tauri/src/commands/backup.rs
Vault and persistence
- Vault session
src-tauri/src/vault/session.rs - Vault header
src-tauri/src/vault/header.rs - Encrypted entries
src-tauri/src/vault/entries.rs - Encrypted files
src-tauri/src/vault/files.rs - Encrypted backups
src-tauri/src/vault/backup.rs - Local SQLite
src-tauri/src/storage/db.rs
Cryptography and security
- Crypto primitives
src-tauri/src/crypto - Lock and clipboard
src-tauri/src/security/mod.rs - Application state
src-tauri/src/state.rs
Other components
- Vault user
Connections 32
- Vault user → App flow: uses
README.md - App flow → Vault API: checks status
src/App.tsx - App flow → Setup and unlock: shows setup
src/App.tsx - App flow → Vault workspace: shows workspace
src/App.tsx - Setup and unlock → Vault API: creates vault
src/screens/SetupScreen.tsx - Setup and unlock → Backup UI: offers restore
src/screens/SetupScreen.tsx - Vault workspace → File management UI: renders
src/screens/VaultScreen.tsx - File management UI → File API: manages files
src/screens/FilesTab.tsx - Password entry UI → Entry API: manages entries
- Backup UI → Backup API: restores backup
src/components/RestoreBackupForm.tsx - Vault API → Tauri API client: invokes
src/api/vault.ts - Security API → Tauri API client: invokes
src/api/security.ts - File API → Tauri API client: invokes
src/api/files.ts - Backup API → Tauri API client: invokes
src/api/backup.ts - Tauri API client → Command registration: dispatches commands
src-tauri/src/lib.rs - Command registration → Vault commands: registers
src-tauri/src/lib.rs - Command registration → Entry commands: registers
src-tauri/src/lib.rs - Command registration → File commands: registers
src-tauri/src/lib.rs - Command registration → Security commands: registers
src-tauri/src/lib.rs - Command registration → Backup commands: registers
src-tauri/src/lib.rs - Command registration → Application state: initializes
src-tauri/src/lib.rs - Application state → Vault session: holds vault
- Vault session → Vault header: uses
src-tauri/src/vault/session.rs - Vault session → Local SQLite: uses
src-tauri/src/vault/session.rs - Vault session → Crypto primitives: derives keys
src-tauri/src/vault/session.rs - Vault commands → Vault session: controls session
- Entry commands → Encrypted entries: dispatches entry work
- File commands → Encrypted files: dispatches file work
- Backup commands → Encrypted backups: dispatches backup work
- Security commands → Lock and clipboard: dispatches security work
- Lock and clipboard → Application state: tracks activity
src-tauri/src/security/mod.rs - Lock and clipboard → Vault user: clears clipboard
README.md