# rajatdas-dev/device_diagnostics architecture

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

- Interactive diagram: https://gitdiagram.com/rajatdas-dev/device_diagnostics
- Repository: https://github.com/rajatdas-dev/device_diagnostics

## Overview

device_diagnostics is an opt-in Flutter package for collecting device and app diagnostics, monitoring runtime activity, and exporting session reports. The documented workflow is to initialize with visibility and sampling configuration, wrap the app with its diagnostic UI, optionally track routes and instrument HTTP requests, then start and stop a session to produce a PDF. The README supports these user-facing relationships; Dart implementation excerpts were not provided, so internal wiring—especially how Flutter requests native metrics—is not verified here.

Main entry points: [`lib/src/core/diagnostic_controller.dart`](https://github.com/rajatdas-dev/device_diagnostics/blob/main/lib/src/core/diagnostic_controller.dart) (Session Controller), [`lib/src/overlay/diagnostic_observability.dart`](https://github.com/rajatdas-dev/device_diagnostics/blob/main/lib/src/overlay/diagnostic_observability.dart) (App Observability), [`lib/src/models/diagnostic_sample.dart`](https://github.com/rajatdas-dev/device_diagnostics/blob/main/lib/src/models/diagnostic_sample.dart) (Diagnostic Samples), [`lib/src/navigation/diagnostic_route_observer.dart`](https://github.com/rajatdas-dev/device_diagnostics/blob/main/lib/src/navigation/diagnostic_route_observer.dart) (Route Observer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Configuration and Sampling"]
  node_config["Diagnostic Config"]
  node_sample["Diagnostic Samples"]
end

subgraph group_runtime["Runtime Monitoring"]
  node_observability["App Observability"]
  node_overlay["Diagnostic Overlay"]
  node_route["Route Observer"]
  node_http["Diagnostic HTTP Client"]
end

subgraph group_session["Sessions and Reporting"]
  node_controller["Session Controller"]
  node_pdf["PDF Report Generator"]
end

subgraph group_platform["Native Platforms"]
  node_android["Android Metrics Plugin"]
  node_ios["iOS Metrics Plugin"]
end

node_developer(("Flutter Developer"))
node_app["Flutter App"]

node_developer -->|"configures"| node_config
node_developer -->|"starts session"| node_controller
node_app -->|"wraps with"| node_observability
node_app -->|"registers observer"| node_route
node_developer -->|"uses client"| node_http
node_controller -->|"exports report"| node_pdf
node_controller -.->|"collects samples"| node_sample
node_observability -->|"uses visibility"| node_config
node_observability -.->|"shows diagnostics"| node_overlay
node_route -->|"associates activity"| node_controller
node_http -->|"records metrics"| node_controller
node_android -.->|"provides metrics"| node_sample
node_ios -.->|"provides metrics"| node_sample

click node_config "https://github.com/rajatdas-dev/device_diagnostics/blob/main/lib/src/config/diagnostic_config.dart"
click node_controller "https://github.com/rajatdas-dev/device_diagnostics/blob/main/lib/src/core/diagnostic_controller.dart"
click node_sample "https://github.com/rajatdas-dev/device_diagnostics/blob/main/lib/src/models/diagnostic_sample.dart"
click node_observability "https://github.com/rajatdas-dev/device_diagnostics/blob/main/lib/src/overlay/diagnostic_observability.dart"
click node_overlay "https://github.com/rajatdas-dev/device_diagnostics/blob/main/lib/src/overlay/diagnostic_overlay.dart"
click node_route "https://github.com/rajatdas-dev/device_diagnostics/blob/main/lib/src/navigation/diagnostic_route_observer.dart"
click node_http "https://github.com/rajatdas-dev/device_diagnostics/blob/main/lib/src/network/diagnostic_http_client.dart"
click node_pdf "https://github.com/rajatdas-dev/device_diagnostics/blob/main/lib/src/reporting/diagnostic_pdf_report.dart"
click node_android "https://github.com/rajatdas-dev/device_diagnostics/blob/main/android/src/main/kotlin/dev/diagnostics/device_diagnostics/DeviceDiagnosticsPlugin.kt"
click node_ios "https://github.com/rajatdas-dev/device_diagnostics/blob/main/ios/Classes/DeviceDiagnosticsPlugin.swift"

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_config,node_sample toneBlue
class node_observability,node_overlay,node_route,node_http toneAmber
class node_controller,node_pdf toneMint
class node_android,node_ios toneRose
class node_developer,node_app toneIndigo
```

## Components

### Configuration and Sampling

- [Diagnostic Config](https://github.com/rajatdas-dev/device_diagnostics/blob/main/lib/src/config/diagnostic_config.dart): `lib/src/config/diagnostic_config.dart`
- [Diagnostic Samples](https://github.com/rajatdas-dev/device_diagnostics/blob/main/lib/src/models/diagnostic_sample.dart): `lib/src/models/diagnostic_sample.dart`

### Runtime Monitoring

- [App Observability](https://github.com/rajatdas-dev/device_diagnostics/blob/main/lib/src/overlay/diagnostic_observability.dart): `lib/src/overlay/diagnostic_observability.dart`
- [Diagnostic Overlay](https://github.com/rajatdas-dev/device_diagnostics/blob/main/lib/src/overlay/diagnostic_overlay.dart): `lib/src/overlay/diagnostic_overlay.dart`
- [Route Observer](https://github.com/rajatdas-dev/device_diagnostics/blob/main/lib/src/navigation/diagnostic_route_observer.dart): `lib/src/navigation/diagnostic_route_observer.dart`
- [Diagnostic HTTP Client](https://github.com/rajatdas-dev/device_diagnostics/blob/main/lib/src/network/diagnostic_http_client.dart): `lib/src/network/diagnostic_http_client.dart`

### Sessions and Reporting

- [Session Controller](https://github.com/rajatdas-dev/device_diagnostics/blob/main/lib/src/core/diagnostic_controller.dart): `lib/src/core/diagnostic_controller.dart`
- [PDF Report Generator](https://github.com/rajatdas-dev/device_diagnostics/blob/main/lib/src/reporting/diagnostic_pdf_report.dart): `lib/src/reporting/diagnostic_pdf_report.dart`

### Native Platforms

- [Android Metrics Plugin](https://github.com/rajatdas-dev/device_diagnostics/blob/main/android/src/main/kotlin/dev/diagnostics/device_diagnostics/DeviceDiagnosticsPlugin.kt): `android/src/main/kotlin/dev/diagnostics/device_diagnostics/DeviceDiagnosticsPlugin.kt`
- [iOS Metrics Plugin](https://github.com/rajatdas-dev/device_diagnostics/blob/main/ios/Classes/DeviceDiagnosticsPlugin.swift): `ios/Classes/DeviceDiagnosticsPlugin.swift`

### Other components

- **Flutter Developer**
- **Flutter App**

## Connections

- Flutter Developer → Diagnostic Config: configures (evidence: `README.md`)
- Flutter Developer → Session Controller: starts session (evidence: `README.md`)
- Flutter App → App Observability: wraps with (evidence: `README.md`)
- Flutter App → Route Observer: registers observer (evidence: `README.md`)
- Flutter Developer → Diagnostic HTTP Client: uses client (evidence: `README.md`)
- Session Controller → PDF Report Generator: exports report (evidence: `README.md`)
- Session Controller → Diagnostic Samples: collects samples
- App Observability → Diagnostic Config: uses visibility (evidence: `README.md`)
- App Observability → Diagnostic Overlay: shows diagnostics
- Route Observer → Session Controller: associates activity (evidence: `README.md`)
- Diagnostic HTTP Client → Session Controller: records metrics (evidence: `README.md`)
- Android Metrics Plugin → Diagnostic Samples: provides metrics
- iOS Metrics Plugin → Diagnostic Samples: provides metrics
