How chaniug/vaultix works
Vaultix is an Android password manager that unifies Bitwarden cloud vaults and local or cloud-hosted KeePass KDBX files behind shared vault and item models. The main workflow is to add or unlock a vault, browse and manage credentials, and sync changes through the appropriate provider; Android autofill and passkey flows expose credentials to other apps. The README documents several capabilities whose implementation was not sampled, so those branches are represented at their supported directory paths. Edges are limited to README statements and visible source references; unsampled wiring is omitted.
Main entry points: ui Vault UI · VaultixAutofillService.kt Autofill service · kdbx KDBX cloud sync · items Credential management
Components 25
Vault lifecycle
- Vault UI
app/src/main/java/io/vaultix/vaultix/ui - Add vault
app/src/main/java/io/vaultix/vaultix/ui/addvault - Unlock flow
app/src/main/java/io/vaultix/vaultix/ui/unlock - Vault repository
domain/src/main/java/io/vaultix/domain/VaultRepository.kt - Vault sessions
data/repository/src/main/java/io/vaultix/data/repository/VaultSessionManager.kt
Vault providers
- Bitwarden sync
data/bitwarden/src/main/java/io/vaultix/data/bitwarden/sync/BitwardenSyncService.kt - Bitwarden login
data/bitwarden/src/main/java/io/vaultix/data/bitwarden/auth/BitwardenAuthRepository.kt - KDBX engine
data/kdbx/src/main/java/io/vaultix/data/kdbx/KdbxEngine.kt - KDBX cloud sync
data/repository/src/main/java/io/vaultix/data/repository/kdbx - OneDrive source
app/src/main/java/io/vaultix/vaultix/remote/onedrive - WebDAV source
data/repository/src/main/java/io/vaultix/data/repository/kdbx/WebDavKdbxFileSource.kt
Credential experience
- Credential management
app/src/main/java/io/vaultix/vaultix/ui/items - Credential details
app/src/main/java/io/vaultix/vaultix/ui/detail - OTP codes
app/src/main/java/io/vaultix/vaultix/ui/totp - Card wallet
app/src/main/java/io/vaultix/vaultix/ui/cardwallet
Android integration
- Autofill service
app/src/main/java/io/vaultix/vaultix/autofill/VaultixAutofillService.kt - Fill candidates
app/src/main/java/io/vaultix/vaultix/autofill/engine/AutofillCandidateSource.kt - Fill assistance
app/src/main/java/io/vaultix/vaultix/autofill/fillassist - Passkey provider
app/src/main/java/io/vaultix/vaultix/passkey - Save credentials
app/src/main/java/io/vaultix/vaultix/autofill/save
Shared foundations
- Cryptography
core/crypto/src/main/java/io/vaultix/crypto - Room cache
core/database/src/main/java/io/vaultix/database/VaultixDatabase.kt - Preferences
core/datastore/src/main/java/io/vaultix/datastore/VaultixPreferences.kt - Shared item model
core/model/src/main/java/io/vaultix/model/VaultItem.kt
Other components
- Vault user
Connections 24
- Vault user → Vault UI: uses
README.md - Vault UI → Add vault: adds vaults
README.md - Vault UI → Unlock flow: opens vaults
README.md - Vault UI → Vault repository: manages lifecycle
README.md - Vault repository → Vault sessions: tracks sessions
- Vault UI → Credential management: manages entries
README.md - Credential management → Credential details: opens details
- Vault UI → OTP codes: shows codes
README.md - Vault UI → Card wallet: manages cards
README.md - Vault user → Autofill service: requests fill
README.md - Autofill service → Fill candidates: gets candidates
app/src/main/java/io/vaultix/vaultix/autofill/VaultixAutofillService.kt - Autofill service → Fill assistance: loads rules
app/src/main/java/io/vaultix/vaultix/autofill/VaultixAutofillService.kt - Autofill service → Save credentials: offers save
app/src/main/java/io/vaultix/vaultix/autofill/VaultixAutofillService.kt - Vault user → Passkey provider: uses passkeys
README.md - Vault user → Bitwarden login: authenticates
README.md - Bitwarden login → Cryptography: derives keys
data/bitwarden/src/main/java/io/vaultix/data/bitwarden/auth/BitwardenAuthRepository.kt - Bitwarden sync → Room cache: stores sync data
data/bitwarden/src/main/java/io/vaultix/data/bitwarden/sync/BitwardenSyncService.kt - Vault user → KDBX engine: opens KDBX
README.md - Vault user → KDBX cloud sync: syncs KDBX
README.md - KDBX cloud sync → OneDrive source: uses source
- KDBX cloud sync → WebDAV source: uses source
- KDBX engine → Cryptography: protects vault
- Credential management → Shared item model: uses shared model
README.md - Autofill service → Preferences: reads settings
app/src/main/java/io/vaultix/vaultix/autofill/VaultixAutofillService.kt