# ksandariv/zibaldone architecture

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

- Interactive diagram: https://gitdiagram.com/ksandariv/zibaldone
- Repository: https://github.com/ksandariv/zibaldone

## Overview

ZibaldOne is a local-first personal organizer for Windows and Android, with a shared Python core and CLI. The main workflow is to compose a template from blocks, fill it in through the interface, and store entries locally for later use; domain modules add areas, finance, habits, people, search, and related tools. Backups, encryption, privacy/anonymization, reminders, and optional cloud sync are important supporting capabilities. Some connections below are documented or indexed rather than visible in the sampled excerpts, so those are marked dashed.

Main entry points: [`ZibaldOne/src/zibaldone/ui/app.py`](https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/ui/app.py) (Flet app), [`ZibaldOne/src/zibaldone/storage/database.py`](https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/storage/database.py) (SQLite store), [`ZibaldOne/src/zibaldone/storage/backups.py`](https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/storage/backups.py) (Snapshots), [`ZibaldOne/src/zibaldone/cli/app.py`](https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/cli/app.py) (CLI commands)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["User interfaces"]
  node_ui["Flet app<br/>[app.py]"]
  node_views["Entry and views<br/>[entry_form.py]"]
  node_cli["CLI commands<br/>[app.py]"]
end

subgraph group_domain["Personal tools"]
  node_templates["Templates<br/>[templates.py]"]
  node_blocks["Entry blocks<br/>[blocks.py]"]
  node_areas["Life areas<br/>[areas.py]"]
  node_finance["Finance<br/>[finance.py]"]
  node_habits["Habits<br/>[habits.py]"]
  node_people["People<br/>[people.py]"]
  node_search["Search<br/>[search.py]"]
  node_stats["Statistics<br/>[stats.py]"]
end

subgraph group_persistence["Local data"]
  node_store[("SQLite store<br/>[database.py]")]
  node_settings["Settings<br/>[settings.py]"]
end

subgraph group_protection["Privacy and backup"]
  node_crypto["Encryption<br/>[crypto.py]"]
  node_anonymizer["Anonymizer<br/>[anonymizer.py]"]
  node_backups["Snapshots<br/>[backups.py]"]
  node_keys["Backup keys<br/>[keys.py]"]
end

subgraph group_services["Background services"]
  node_cloud["Cloud sync<br/>[sync.py]"]
  node_reminders["Reminder rules<br/>[reminders.py]"]
  node_delivery["Reminder delivery<br/>[service.py]"]
end

node_person(("User"))

node_person -->|"uses"| node_ui
node_person -.->|"uses"| node_cli
node_ui -->|"routes to"| node_views
node_views -->|"reads and writes"| node_store
node_views -->|"uses"| node_templates
node_templates -->|"defines"| node_blocks
node_store -->|"uses"| node_templates
node_store -->|"uses"| node_areas
node_store -->|"uses"| node_search
node_store -->|"uses"| node_crypto
node_cli -.->|"opens"| node_store
node_cli -->|"manages"| node_backups
node_cli -->|"uses"| node_crypto
node_cloud -->|"syncs snapshots"| node_backups
node_cloud -->|"uses"| node_crypto
node_backups -->|"uses"| node_keys
node_backups -->|"snapshots"| node_store
node_backups -->|"encrypts"| node_crypto
node_ui -->|"reads preferences"| node_settings
node_ui -.->|"offers privacy tools"| node_anonymizer
node_ui -.->|"offers finance tools"| node_finance
node_ui -.->|"offers habit tools"| node_habits
node_ui -.->|"offers people tools"| node_people
node_ui -.->|"offers statistics"| node_stats
node_delivery -->|"evaluates rules"| node_reminders
node_ui -.->|"runs reminder service"| node_delivery

click node_ui "https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/ui/app.py"
click node_views "https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/ui/views/entry_form.py"
click node_cli "https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/cli/app.py"
click node_templates "https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/core/templates.py"
click node_blocks "https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/core/blocks.py"
click node_areas "https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/core/areas.py"
click node_finance "https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/core/finance.py"
click node_habits "https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/core/habits.py"
click node_people "https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/core/people.py"
click node_search "https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/core/search.py"
click node_stats "https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/core/stats.py"
click node_store "https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/storage/database.py"
click node_settings "https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/storage/settings.py"
click node_crypto "https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/core/crypto.py"
click node_anonymizer "https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/core/anonymizer.py"
click node_backups "https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/storage/backups.py"
click node_keys "https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/storage/keys.py"
click node_cloud "https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/cloud/sync.py"
click node_reminders "https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/core/reminders.py"
click node_delivery "https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/notify/service.py"

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_ui,node_views,node_cli,node_person toneBlue
class node_templates,node_blocks,node_areas,node_finance,node_habits,node_people,node_search,node_stats toneAmber
class node_store,node_settings toneMint
class node_crypto,node_anonymizer,node_backups,node_keys toneRose
class node_cloud,node_reminders,node_delivery toneIndigo
```

## Components

### User interfaces

- [Flet app](https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/ui/app.py): `ZibaldOne/src/zibaldone/ui/app.py`
- [Entry and views](https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/ui/views/entry_form.py): `ZibaldOne/src/zibaldone/ui/views/entry_form.py`
- [CLI commands](https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/cli/app.py): `ZibaldOne/src/zibaldone/cli/app.py`

### Personal tools

- [Templates](https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/core/templates.py): `ZibaldOne/src/zibaldone/core/templates.py`
- [Entry blocks](https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/core/blocks.py): `ZibaldOne/src/zibaldone/core/blocks.py`
- [Life areas](https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/core/areas.py): `ZibaldOne/src/zibaldone/core/areas.py`
- [Finance](https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/core/finance.py): `ZibaldOne/src/zibaldone/core/finance.py`
- [Habits](https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/core/habits.py): `ZibaldOne/src/zibaldone/core/habits.py`
- [People](https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/core/people.py): `ZibaldOne/src/zibaldone/core/people.py`
- [Search](https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/core/search.py): `ZibaldOne/src/zibaldone/core/search.py`
- [Statistics](https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/core/stats.py): `ZibaldOne/src/zibaldone/core/stats.py`

### Local data

- [SQLite store](https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/storage/database.py): `ZibaldOne/src/zibaldone/storage/database.py`
- [Settings](https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/storage/settings.py): `ZibaldOne/src/zibaldone/storage/settings.py`

### Privacy and backup

- [Encryption](https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/core/crypto.py): `ZibaldOne/src/zibaldone/core/crypto.py`
- [Anonymizer](https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/core/anonymizer.py): `ZibaldOne/src/zibaldone/core/anonymizer.py`
- [Snapshots](https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/storage/backups.py): `ZibaldOne/src/zibaldone/storage/backups.py`
- [Backup keys](https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/storage/keys.py): `ZibaldOne/src/zibaldone/storage/keys.py`

### Background services

- [Cloud sync](https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/cloud/sync.py): `ZibaldOne/src/zibaldone/cloud/sync.py`
- [Reminder rules](https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/core/reminders.py): `ZibaldOne/src/zibaldone/core/reminders.py`
- [Reminder delivery](https://github.com/ksandariv/zibaldone/blob/main/ZibaldOne/src/zibaldone/notify/service.py): `ZibaldOne/src/zibaldone/notify/service.py`

### Other components

- **User**

## Connections

- User → Flet app: uses (evidence: `ZibaldOne/src/zibaldone/ui/app.py`)
- User → CLI commands: uses (evidence: `ZibaldOne/src/zibaldone/cli/app.py`)
- Flet app → Entry and views: routes to (evidence: `ZibaldOne/src/zibaldone/ui/app.py`)
- Entry and views → SQLite store: reads and writes (evidence: `ZibaldOne/src/zibaldone/ui/views/entry_form.py`)
- Entry and views → Templates: uses (evidence: `ZibaldOne/src/zibaldone/ui/views/entry_form.py`)
- Templates → Entry blocks: defines (evidence: `ZibaldOne/src/zibaldone/core/templates.py`)
- SQLite store → Templates: uses (evidence: `ZibaldOne/src/zibaldone/storage/database.py`)
- SQLite store → Life areas: uses (evidence: `ZibaldOne/src/zibaldone/storage/database.py`)
- SQLite store → Search: uses (evidence: `ZibaldOne/src/zibaldone/storage/database.py`)
- SQLite store → Encryption: uses (evidence: `ZibaldOne/src/zibaldone/storage/database.py`)
- CLI commands → SQLite store: opens (evidence: `ZibaldOne/src/zibaldone/cli/app.py`)
- CLI commands → Snapshots: manages
- CLI commands → Encryption: uses
- Cloud sync → Snapshots: syncs snapshots (evidence: `ZibaldOne/src/zibaldone/cloud/sync.py`)
- Cloud sync → Encryption: uses (evidence: `ZibaldOne/src/zibaldone/cloud/sync.py`)
- Snapshots → Backup keys: uses (evidence: `ZibaldOne/src/zibaldone/storage/backups.py`)
- Snapshots → SQLite store: snapshots (evidence: `ZibaldOne/src/zibaldone/storage/backups.py`)
- Snapshots → Encryption: encrypts (evidence: `ZibaldOne/src/zibaldone/storage/backups.py`)
- Flet app → Settings: reads preferences (evidence: `ZibaldOne/src/zibaldone/ui/app.py`)
- Flet app → Anonymizer: offers privacy tools
- Flet app → Finance: offers finance tools
- Flet app → Habits: offers habit tools
- Flet app → People: offers people tools
- Flet app → Statistics: offers statistics
- Reminder delivery → Reminder rules: evaluates rules (evidence: `ZibaldOne/src/zibaldone/notify/service.py`)
- Flet app → Reminder delivery: runs reminder service
