# thoma411/keeledger architecture

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

- Interactive diagram: https://gitdiagram.com/thoma411/keeledger
- Repository: https://github.com/thoma411/keeledger

## Overview

Keeledger is a Flutter password manager whose documented workflow is to create a local database, establish a master password and recovery key, then add and search account entries. Its main capability branches cover encrypted local storage, WebDAV backup, CSV migration, and settings/help. The Dart implementation was not excerpted, so app-level links below are limited to README-documented relationships; native host relationships are based on the shown startup code and SOURCE INDEX references.

Main entry points: [`lib/pages/account_list_page.dart`](https://github.com/thoma411/keeledger/blob/main/lib/pages/account_list_page.dart) (Account browser), [`lib/services/storage_service.dart`](https://github.com/thoma411/keeledger/blob/main/lib/services/storage_service.dart) (Local database), [`lib/services/auth_service.dart`](https://github.com/thoma411/keeledger/blob/main/lib/services/auth_service.dart) (Authentication), [`lib/services/csv_service.dart`](https://github.com/thoma411/keeledger/blob/main/lib/services/csv_service.dart) (CSV migration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Password manager"]
  node_entry["Flutter app<br/>[main.dart]"]
  node_accounts["Account browser"]
  node_account_model["Account records<br/>[account.dart]"]
  node_account_detail["Account details"]
  node_account_card["Account cards<br/>[account_card.dart]"]
  node_add_account["Add account"]
  node_settings["Settings<br/>[settings_page.dart]"]
  node_help["Help guide<br/>[help.md]"]
end

subgraph group_security["Vault and security"]
  node_login["Vault login<br/>[login_page.dart]"]
  node_auth["Authentication<br/>[auth_service.dart]"]
  node_security_service["Encryption security"]
  node_biometric["Biometric unlock"]
end

subgraph group_data["Data and sync"]
  node_storage[("Local database")]
  node_sync_page["Sync controls<br/>[sync_page.dart]"]
  node_webdav["WebDAV sync"]
  node_csv["CSV migration<br/>[csv_service.dart]"]
  node_csv_mapper["CSV mapping"]
end

subgraph group_hosts["Platform hosts"]
  node_win_main["Windows launcher<br/>[main.cpp]"]
  node_win_flutter["Windows Flutter host<br/>[flutter_window.h]"]
  node_win_window["Windows window<br/>[win32_window.h]"]
  node_linux_main["Linux launcher<br/>[main.cc]"]
  node_linux_app["Linux application<br/>[my_application.h]"]
  node_linux_plugins["Linux plugin registry"]
  node_windows_plugins["Windows plugin registry"]
end

node_user(("User"))

node_user -->|"opens"| node_entry
node_entry -.->|"starts vault"| node_login
node_user -->|"adds entries"| node_accounts
node_accounts -.->|"manages records"| node_account_model
node_accounts -.->|"shows details"| node_account_detail
node_accounts -.->|"displays entries"| node_account_card
node_accounts -.->|"offers creation"| node_add_account
node_login -.->|"authenticates"| node_auth
node_auth -.->|"uses encryption"| node_security_service
node_auth -.->|"supports unlock"| node_biometric
node_security_service -->|"protects stored data"| node_storage
node_accounts -.->|"stores entries"| node_storage
node_user -->|"configures backup"| node_sync_page
node_sync_page -.->|"starts sync"| node_webdav
node_webdav -->|"backs up encrypted data"| node_storage
node_user -->|"imports or exports"| node_csv
node_csv -.->|"maps account data"| node_csv_mapper
node_csv -.->|"migrates entries"| node_storage
node_user -->|"opens settings"| node_settings
node_settings -->|"opens guide"| node_help
node_win_main -->|"creates host"| node_win_flutter
node_win_flutter -->|"extends window"| node_win_window
node_linux_main -->|"creates application"| node_linux_app
node_linux_app -->|"registers plugins"| node_linux_plugins
node_win_flutter -.->|"registers plugins"| node_windows_plugins

click node_entry "https://github.com/thoma411/keeledger/blob/main/lib/main.dart"
click node_accounts "https://github.com/thoma411/keeledger/blob/main/lib/pages/account_list_page.dart"
click node_account_model "https://github.com/thoma411/keeledger/blob/main/lib/models/account.dart"
click node_account_detail "https://github.com/thoma411/keeledger/blob/main/lib/widgets/account_detail_view.dart"
click node_account_card "https://github.com/thoma411/keeledger/blob/main/lib/widgets/account_card.dart"
click node_add_account "https://github.com/thoma411/keeledger/blob/main/lib/widgets/add_account_dialog.dart"
click node_login "https://github.com/thoma411/keeledger/blob/main/lib/pages/login_page.dart"
click node_auth "https://github.com/thoma411/keeledger/blob/main/lib/services/auth_service.dart"
click node_security_service "https://github.com/thoma411/keeledger/blob/main/lib/services/security_service.dart"
click node_biometric "https://github.com/thoma411/keeledger/blob/main/lib/services/biometric_keystore.dart"
click node_storage "https://github.com/thoma411/keeledger/blob/main/lib/services/storage_service.dart"
click node_sync_page "https://github.com/thoma411/keeledger/blob/main/lib/pages/sync_page.dart"
click node_webdav "https://github.com/thoma411/keeledger/blob/main/lib/services/webdav_service.dart"
click node_csv "https://github.com/thoma411/keeledger/blob/main/lib/services/csv_service.dart"
click node_csv_mapper "https://github.com/thoma411/keeledger/blob/main/lib/services/account_csv_mapper.dart"
click node_settings "https://github.com/thoma411/keeledger/blob/main/lib/pages/settings_page.dart"
click node_help "https://github.com/thoma411/keeledger/blob/main/assets/docs/help.md"
click node_win_main "https://github.com/thoma411/keeledger/blob/main/windows/runner/main.cpp"
click node_win_flutter "https://github.com/thoma411/keeledger/blob/main/windows/runner/flutter_window.h"
click node_win_window "https://github.com/thoma411/keeledger/blob/main/windows/runner/win32_window.h"
click node_linux_main "https://github.com/thoma411/keeledger/blob/main/linux/runner/main.cc"
click node_linux_app "https://github.com/thoma411/keeledger/blob/main/linux/runner/my_application.h"
click node_linux_plugins "https://github.com/thoma411/keeledger/blob/main/linux/flutter/generated_plugin_registrant.h"
click node_windows_plugins "https://github.com/thoma411/keeledger/blob/main/windows/flutter/generated_plugin_registrant.h"

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_entry,node_accounts,node_account_model,node_account_detail,node_account_card,node_add_account,node_settings,node_help,node_user toneBlue
class node_login,node_auth,node_security_service,node_biometric toneAmber
class node_storage,node_sync_page,node_webdav,node_csv,node_csv_mapper toneMint
class node_win_main,node_win_flutter,node_win_window,node_linux_main,node_linux_app,node_linux_plugins,node_windows_plugins toneRose
```

## Components

### Password manager

- [Flutter app](https://github.com/thoma411/keeledger/blob/main/lib/main.dart): `lib/main.dart`
- [Account browser](https://github.com/thoma411/keeledger/blob/main/lib/pages/account_list_page.dart): `lib/pages/account_list_page.dart`
- [Account records](https://github.com/thoma411/keeledger/blob/main/lib/models/account.dart): `lib/models/account.dart`
- [Account details](https://github.com/thoma411/keeledger/blob/main/lib/widgets/account_detail_view.dart): `lib/widgets/account_detail_view.dart`
- [Account cards](https://github.com/thoma411/keeledger/blob/main/lib/widgets/account_card.dart): `lib/widgets/account_card.dart`
- [Add account](https://github.com/thoma411/keeledger/blob/main/lib/widgets/add_account_dialog.dart): `lib/widgets/add_account_dialog.dart`
- [Settings](https://github.com/thoma411/keeledger/blob/main/lib/pages/settings_page.dart): `lib/pages/settings_page.dart`
- [Help guide](https://github.com/thoma411/keeledger/blob/main/assets/docs/help.md): `assets/docs/help.md`

### Vault and security

- [Vault login](https://github.com/thoma411/keeledger/blob/main/lib/pages/login_page.dart): `lib/pages/login_page.dart`
- [Authentication](https://github.com/thoma411/keeledger/blob/main/lib/services/auth_service.dart): `lib/services/auth_service.dart`
- [Encryption security](https://github.com/thoma411/keeledger/blob/main/lib/services/security_service.dart): `lib/services/security_service.dart`
- [Biometric unlock](https://github.com/thoma411/keeledger/blob/main/lib/services/biometric_keystore.dart): `lib/services/biometric_keystore.dart`

### Data and sync

- [Local database](https://github.com/thoma411/keeledger/blob/main/lib/services/storage_service.dart): `lib/services/storage_service.dart`
- [Sync controls](https://github.com/thoma411/keeledger/blob/main/lib/pages/sync_page.dart): `lib/pages/sync_page.dart`
- [WebDAV sync](https://github.com/thoma411/keeledger/blob/main/lib/services/webdav_service.dart): `lib/services/webdav_service.dart`
- [CSV migration](https://github.com/thoma411/keeledger/blob/main/lib/services/csv_service.dart): `lib/services/csv_service.dart`
- [CSV mapping](https://github.com/thoma411/keeledger/blob/main/lib/services/account_csv_mapper.dart): `lib/services/account_csv_mapper.dart`

### Platform hosts

- [Windows launcher](https://github.com/thoma411/keeledger/blob/main/windows/runner/main.cpp): `windows/runner/main.cpp`
- [Windows Flutter host](https://github.com/thoma411/keeledger/blob/main/windows/runner/flutter_window.h): `windows/runner/flutter_window.h`
- [Windows window](https://github.com/thoma411/keeledger/blob/main/windows/runner/win32_window.h): `windows/runner/win32_window.h`
- [Linux launcher](https://github.com/thoma411/keeledger/blob/main/linux/runner/main.cc): `linux/runner/main.cc`
- [Linux application](https://github.com/thoma411/keeledger/blob/main/linux/runner/my_application.h): `linux/runner/my_application.h`
- [Linux plugin registry](https://github.com/thoma411/keeledger/blob/main/linux/flutter/generated_plugin_registrant.h): `linux/flutter/generated_plugin_registrant.h`
- [Windows plugin registry](https://github.com/thoma411/keeledger/blob/main/windows/flutter/generated_plugin_registrant.h): `windows/flutter/generated_plugin_registrant.h`

### Other components

- **User**

## Connections

- User → Flutter app: opens (evidence: `README.md`)
- Flutter app → Vault login: starts vault
- User → Account browser: adds entries (evidence: `README.md`)
- Account browser → Account records: manages records
- Account browser → Account details: shows details
- Account browser → Account cards: displays entries
- Account browser → Add account: offers creation
- Vault login → Authentication: authenticates
- Authentication → Encryption security: uses encryption
- Authentication → Biometric unlock: supports unlock
- Encryption security → Local database: protects stored data (evidence: `README.md`)
- Account browser → Local database: stores entries
- User → Sync controls: configures backup (evidence: `README.md`)
- Sync controls → WebDAV sync: starts sync
- WebDAV sync → Local database: backs up encrypted data (evidence: `README.md`)
- User → CSV migration: imports or exports (evidence: `README.md`)
- CSV migration → CSV mapping: maps account data
- CSV migration → Local database: migrates entries
- User → Settings: opens settings (evidence: `README.md`)
- Settings → Help guide: opens guide (evidence: `README.md`)
- Windows launcher → Windows Flutter host: creates host (evidence: `windows/runner/main.cpp`)
- Windows Flutter host → Windows window: extends window (evidence: `windows/runner/flutter_window.h`)
- Linux launcher → Linux application: creates application (evidence: `linux/runner/main.cc`)
- Linux application → Linux plugin registry: registers plugins (evidence: `linux/runner/my_application.cc`)
- Windows Flutter host → Windows plugin registry: registers plugins
