# getditto/dittoandroidtools architecture

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

- Interactive diagram: https://gitdiagram.com/getditto/dittoandroidtools
- Repository: https://github.com/getditto/dittoandroidtools

## Overview

DittoAndroidTools is an Android diagnostic-tools library for applications embedding the Ditto Kotlin SDK. Its principal workflow is to provide an initialized Ditto instance to the Tools Viewer, whose menu/navigation opens peer and presence diagnostics, data browsing, logs, disk usage, health, and heartbeat features. Individual screens then inspect local Ditto state or device status and present results; optional export paths package or upload diagnostic data. The graph emphasizes documented capabilities and sampled caller relationships; several feature internals are unsampled, so those links are documented or omitted rather than inferred.

Main entry points: [`DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/DittoToolsViewer.kt`](https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/DittoToolsViewer.kt) (Tools Viewer), [`DittoToolsAndroid/src/main/java/com/ditto/tools/logviewer/LogViewerScreen.kt`](https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/logviewer/LogViewerScreen.kt) (Log viewer), [`DittoToolsAndroid/src/main/java/com/ditto/tools/presencedegradationreporter/PresenceDegradationReporterViewModel.kt`](https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/presencedegradationreporter/PresenceDegradationReporterViewModel.kt) (Presence state logic), [`DittoToolsAndroid/src/main/java/com/ditto/tools/presencedegradationreporter/repositories/PeersRepository.kt`](https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/presencedegradationreporter/repositories/PeersRepository.kt) (Peer state repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Viewer and navigation"]
  node_viewer["Tools Viewer"]
  node_menu["Tools menu<br/>[ToolsMenu.kt]"]
  node_routes["Screen routes<br/>[Screens.kt]"]
  node_viewer_state["Menu model"]
end

subgraph group_diagnostics["Peer diagnostics"]
  node_peer_list["Connected peers<br/>[PeersListViewer.kt]"]
  node_presence["Presence mesh viewer"]
  node_degradation["Presence degradation"]
  node_presence_vm["Presence state logic"]
  node_presence_repo[("Peer state repository<br/>[PeersRepository.kt]")]
  node_presence_models["Peer models<br/>[Peer.kt]"]
  node_dashboard["Peer dashboard<br/>[Dashboard.kt]"]
end

subgraph group_data["Data and storage"]
  node_browser["Data browser<br/>[DataBrowser.kt]"]
  node_disk["Disk usage and export<br/>[DittoDiskUsage.kt]"]
  node_disk_metrics["Disk metrics"]
  node_exporter["Data archive exporter"]
end

subgraph group_health["Health and heartbeat"]
  node_health["Health screen<br/>[HealthScreen.kt]"]
  node_health_metrics["Health metrics<br/>[HealthMetric.kt]"]
  node_metric_provider["Metric providers"]
  node_heartbeat["Heartbeat monitor<br/>[Heartbeat.kt]"]
  node_heartbeat_screen["Heartbeat screen<br/>[HeartbeatScreen.kt]"]
end

subgraph group_logs["Log export"]
  node_log_details["Log controls"]
  node_log_viewer["Log viewer<br/>[LogViewerScreen.kt]"]
  node_log_utils["Log utilities<br/>[LogUtils.kt]"]
  node_log_export["Log file export<br/>[ExportLogs.kt]"]
  node_portal_export["Portal log upload"]
end

node_host(("Embedding app"))
node_ditto["Ditto SDK instance"]
node_portal["Ditto Portal"]

node_host -->|"embeds"| node_viewer
node_host -->|"provides"| node_ditto
node_viewer -->|"accepts"| node_ditto
node_viewer -->|"shows"| node_menu
node_viewer -->|"navigates"| node_routes
node_viewer -->|"uses menu model"| node_viewer_state
node_viewer -->|"routes to"| node_peer_list
node_viewer -->|"routes to"| node_presence
node_viewer -->|"routes to"| node_degradation
node_viewer -->|"routes to"| node_browser
node_viewer -->|"routes to"| node_disk
node_viewer -->|"routes to"| node_health
node_viewer -->|"routes to"| node_heartbeat_screen
node_viewer -->|"routes to"| node_log_details
node_viewer -->|"routes to"| node_log_viewer
node_degradation -->|"collects state"| node_presence_vm
node_presence_vm -->|"observes and updates"| node_presence_repo
node_presence_repo -->|"queries and writes"| node_ditto
node_presence_repo -->|"converts records"| node_presence_models
node_presence_vm -->|"renders state"| node_dashboard
node_disk -.->|"measures usage"| node_disk_metrics
node_disk -.->|"exports directory"| node_exporter
node_disk_metrics -->|"produces metrics"| node_health_metrics
node_health -.->|"reports status"| node_health_metrics
node_heartbeat_screen -.->|"presents monitor"| node_heartbeat
node_heartbeat -->|"collects metrics"| node_metric_provider
node_metric_provider -->|"provides values"| node_health_metrics
node_log_details -->|"opens"| node_log_viewer
node_log_viewer -->|"uses"| node_log_utils
node_log_viewer -.->|"reads logs"| node_ditto
node_portal_export -.->|"uploads logs"| node_portal

click node_viewer "https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/DittoToolsViewer.kt"
click node_menu "https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/ToolsMenu.kt"
click node_routes "https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/navigation/Screens.kt"
click node_viewer_state "https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/viewmodel/ToolsViewerViewModel.kt"
click node_peer_list "https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/peerslist/PeersListViewer.kt"
click node_presence "https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/presenceviewer/DittoPresenceViewer.kt"
click node_degradation "https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/presencedegradationreporter/PresenceDegradationReporterScreen.kt"
click node_presence_vm "https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/presencedegradationreporter/PresenceDegradationReporterViewModel.kt"
click node_presence_repo "https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/presencedegradationreporter/repositories/PeersRepository.kt"
click node_presence_models "https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/presencedegradationreporter/model/Peer.kt"
click node_dashboard "https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/presencedegradationreporter/components/Dashboard.kt"
click node_browser "https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/databrowser/DataBrowser.kt"
click node_disk "https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/diskusage/DittoDiskUsage.kt"
click node_disk_metrics "https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/diskusage/usecase/GetDiskUsageMetrics.kt"
click node_exporter "https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/exporter/ZipFolderUseCase.kt"
click node_health "https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/health/ui/composables/HealthScreen.kt"
click node_health_metrics "https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/healthmetrics/HealthMetric.kt"
click node_metric_provider "https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/healthmetrics/HealthMetricProvider.kt"
click node_heartbeat "https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/heartbeat/Heartbeat.kt"
click node_heartbeat_screen "https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/HeartbeatScreen.kt"
click node_log_details "https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/logviewer/LogDetailsScreen.kt"
click node_log_viewer "https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/logviewer/LogViewerScreen.kt"
click node_log_utils "https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/utils/LogUtils.kt"
click node_log_export "https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/exportlogs/ExportLogs.kt"
click node_portal_export "https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/exportlogs/ExportLogsToPortal.kt"

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_viewer,node_menu,node_routes,node_viewer_state toneBlue
class node_peer_list,node_presence,node_degradation,node_presence_vm,node_presence_repo,node_presence_models,node_dashboard toneAmber
class node_browser,node_disk,node_disk_metrics,node_exporter toneMint
class node_health,node_health_metrics,node_metric_provider,node_heartbeat,node_heartbeat_screen toneRose
class node_log_details,node_log_viewer,node_log_utils,node_log_export,node_portal_export,node_host,node_ditto,node_portal toneIndigo
```

## Components

### Viewer and navigation

- [Tools Viewer](https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/DittoToolsViewer.kt): `DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/DittoToolsViewer.kt`
- [Tools menu](https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/ToolsMenu.kt): `DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/ToolsMenu.kt`
- [Screen routes](https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/navigation/Screens.kt): `DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/navigation/Screens.kt`
- [Menu model](https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/viewmodel/ToolsViewerViewModel.kt): `DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/viewmodel/ToolsViewerViewModel.kt`

### Peer diagnostics

- [Connected peers](https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/peerslist/PeersListViewer.kt): `DittoToolsAndroid/src/main/java/com/ditto/tools/peerslist/PeersListViewer.kt`
- [Presence mesh viewer](https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/presenceviewer/DittoPresenceViewer.kt): `DittoToolsAndroid/src/main/java/com/ditto/tools/presenceviewer/DittoPresenceViewer.kt`
- [Presence degradation](https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/presencedegradationreporter/PresenceDegradationReporterScreen.kt): `DittoToolsAndroid/src/main/java/com/ditto/tools/presencedegradationreporter/PresenceDegradationReporterScreen.kt`
- [Presence state logic](https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/presencedegradationreporter/PresenceDegradationReporterViewModel.kt): `DittoToolsAndroid/src/main/java/com/ditto/tools/presencedegradationreporter/PresenceDegradationReporterViewModel.kt`
- [Peer state repository](https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/presencedegradationreporter/repositories/PeersRepository.kt): `DittoToolsAndroid/src/main/java/com/ditto/tools/presencedegradationreporter/repositories/PeersRepository.kt`
- [Peer models](https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/presencedegradationreporter/model/Peer.kt): `DittoToolsAndroid/src/main/java/com/ditto/tools/presencedegradationreporter/model/Peer.kt`
- [Peer dashboard](https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/presencedegradationreporter/components/Dashboard.kt): `DittoToolsAndroid/src/main/java/com/ditto/tools/presencedegradationreporter/components/Dashboard.kt`

### Data and storage

- [Data browser](https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/databrowser/DataBrowser.kt): `DittoToolsAndroid/src/main/java/com/ditto/tools/databrowser/DataBrowser.kt`
- [Disk usage and export](https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/diskusage/DittoDiskUsage.kt): `DittoToolsAndroid/src/main/java/com/ditto/tools/diskusage/DittoDiskUsage.kt`
- [Disk metrics](https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/diskusage/usecase/GetDiskUsageMetrics.kt): `DittoToolsAndroid/src/main/java/com/ditto/tools/diskusage/usecase/GetDiskUsageMetrics.kt`
- [Data archive exporter](https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/exporter/ZipFolderUseCase.kt): `DittoToolsAndroid/src/main/java/com/ditto/tools/exporter/ZipFolderUseCase.kt`

### Health and heartbeat

- [Health screen](https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/health/ui/composables/HealthScreen.kt): `DittoToolsAndroid/src/main/java/com/ditto/tools/health/ui/composables/HealthScreen.kt`
- [Health metrics](https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/healthmetrics/HealthMetric.kt): `DittoToolsAndroid/src/main/java/com/ditto/tools/healthmetrics/HealthMetric.kt`
- [Metric providers](https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/healthmetrics/HealthMetricProvider.kt): `DittoToolsAndroid/src/main/java/com/ditto/tools/healthmetrics/HealthMetricProvider.kt`
- [Heartbeat monitor](https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/heartbeat/Heartbeat.kt): `DittoToolsAndroid/src/main/java/com/ditto/tools/heartbeat/Heartbeat.kt`
- [Heartbeat screen](https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/HeartbeatScreen.kt): `DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/HeartbeatScreen.kt`

### Log export

- [Log controls](https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/logviewer/LogDetailsScreen.kt): `DittoToolsAndroid/src/main/java/com/ditto/tools/logviewer/LogDetailsScreen.kt`
- [Log viewer](https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/logviewer/LogViewerScreen.kt): `DittoToolsAndroid/src/main/java/com/ditto/tools/logviewer/LogViewerScreen.kt`
- [Log utilities](https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/utils/LogUtils.kt): `DittoToolsAndroid/src/main/java/com/ditto/tools/utils/LogUtils.kt`
- [Log file export](https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/exportlogs/ExportLogs.kt): `DittoToolsAndroid/src/main/java/com/ditto/tools/exportlogs/ExportLogs.kt`
- [Portal log upload](https://github.com/getditto/dittoandroidtools/blob/main/DittoToolsAndroid/src/main/java/com/ditto/tools/exportlogs/ExportLogsToPortal.kt): `DittoToolsAndroid/src/main/java/com/ditto/tools/exportlogs/ExportLogsToPortal.kt`

### Other components

- **Embedding app**
- **Ditto SDK instance**
- **Ditto Portal**

## Connections

- Embedding app → Tools Viewer: embeds (evidence: `README.md`)
- Embedding app → Ditto SDK instance: provides (evidence: `README.md`)
- Tools Viewer → Ditto SDK instance: accepts (evidence: `DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/DittoToolsViewer.kt`)
- Tools Viewer → Tools menu: shows (evidence: `DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/DittoToolsViewer.kt`)
- Tools Viewer → Screen routes: navigates (evidence: `DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/DittoToolsViewer.kt`)
- Tools Viewer → Menu model: uses menu model (evidence: `DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/DittoToolsViewer.kt`)
- Tools Viewer → Connected peers: routes to (evidence: `DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/DittoToolsViewer.kt`)
- Tools Viewer → Presence mesh viewer: routes to (evidence: `DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/DittoToolsViewer.kt`)
- Tools Viewer → Presence degradation: routes to (evidence: `DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/DittoToolsViewer.kt`)
- Tools Viewer → Data browser: routes to (evidence: `DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/DittoToolsViewer.kt`)
- Tools Viewer → Disk usage and export: routes to (evidence: `DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/DittoToolsViewer.kt`)
- Tools Viewer → Health screen: routes to (evidence: `DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/DittoToolsViewer.kt`)
- Tools Viewer → Heartbeat screen: routes to (evidence: `DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/DittoToolsViewer.kt`)
- Tools Viewer → Log controls: routes to (evidence: `DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/DittoToolsViewer.kt`)
- Tools Viewer → Log viewer: routes to (evidence: `DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/DittoToolsViewer.kt`)
- Presence degradation → Presence state logic: collects state (evidence: `DittoToolsAndroid/src/main/java/com/ditto/tools/presencedegradationreporter/PresenceDegradationReporterScreen.kt`)
- Presence state logic → Peer state repository: observes and updates (evidence: `DittoToolsAndroid/src/main/java/com/ditto/tools/presencedegradationreporter/PresenceDegradationReporterViewModel.kt`)
- Peer state repository → Ditto SDK instance: queries and writes (evidence: `DittoToolsAndroid/src/main/java/com/ditto/tools/presencedegradationreporter/repositories/PeersRepository.kt`)
- Peer state repository → Peer models: converts records (evidence: `DittoToolsAndroid/src/main/java/com/ditto/tools/presencedegradationreporter/repositories/PeersRepository.kt`)
- Presence state logic → Peer dashboard: renders state (evidence: `DittoToolsAndroid/src/main/java/com/ditto/tools/presencedegradationreporter/PresenceDegradationReporterScreen.kt`)
- Disk usage and export → Disk metrics: measures usage
- Disk usage and export → Data archive exporter: exports directory
- Disk metrics → Health metrics: produces metrics (evidence: `DittoToolsAndroid/src/main/java/com/ditto/tools/diskusage/usecase/GetDiskUsageMetrics.kt`)
- Health screen → Health metrics: reports status
- Heartbeat screen → Heartbeat monitor: presents monitor
- Heartbeat monitor → Metric providers: collects metrics (evidence: `DittoToolsAndroid/src/main/java/com/ditto/tools/heartbeat/Heartbeat.kt`)
- Metric providers → Health metrics: provides values (evidence: `DittoToolsAndroid/src/main/java/com/ditto/tools/healthmetrics/HealthMetricProvider.kt`)
- Log controls → Log viewer: opens (evidence: `DittoToolsAndroid/src/main/java/com/ditto/tools/logviewer/LogDetailsScreen.kt`)
- Log viewer → Log utilities: uses (evidence: `DittoToolsAndroid/src/main/java/com/ditto/tools/logviewer/LogViewerScreen.kt`)
- Log viewer → Ditto SDK instance: reads logs
- Portal log upload → Ditto Portal: uploads logs
