# quantdale/monitorers architecture

> Architecture diagram of the GitHub repository quantdale/monitorers, 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/quantdale/monitorers
- Repository: https://github.com/quantdale/monitorers

## Overview

This is a Tauri desktop system monitor: the collector samples machine metrics and hardware, the frontend receives live snapshots and lifecycle updates, and the dashboard presents configurable charts and hardware details. The graph includes collection cadence, snapshot/state handling, NVIDIA enrichment, settings, and browser simulation. Source excerpts show the key frontend flows and parts of the collector; unsampled backend command wiring and some UI interactions are not expanded.

Main entry points: [`sys-monitor-tauri/src/App.tsx`](https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src/App.tsx) (Dashboard app), [`sys-monitor-tauri/src/hooks/useMetrics.ts`](https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src/hooks/useMetrics.ts) (Metrics subscription), [`sys-monitor-tauri/src-tauri/src/collector/run_loop.rs`](https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src-tauri/src/collector/run_loop.rs) (Collector tick loop), [`sys-monitor-tauri/src/hooks/useSettings.ts`](https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src/hooks/useSettings.ts) (Settings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dashboard["Dashboard UI"]
  node_app["Dashboard app<br/>[App.tsx]"]
  node_card_render["Card rendering"]
  node_metric_card["Metric cards<br/>[MetricCard.tsx]"]
  node_metric_chart["Metric charts<br/>[MetricChart.tsx]"]
  node_hardware_sidebar["Hardware sidebar"]
end

subgraph group_frontend["Frontend data"]
  node_settings_hook["Settings<br/>[useSettings.ts]"]
  node_settings_store[("Settings store")]
  node_metrics_hook["Metrics subscription<br/>[useMetrics.ts]"]
  node_hardware_hook["Hardware profile hook"]
  node_mock_backend["Browser simulator<br/>[mockBackend.ts]"]
  node_metric_types["Metric contracts<br/>[metrics.ts]"]
end

subgraph group_collector["Metric collection"]
  node_tauri_commands["Tauri commands<br/>[main.rs]"]
  node_run_loop["Collector tick loop<br/>[run_loop.rs]"]
  node_supervisor["Collector supervisor<br/>[supervisor.rs]"]
  node_snapshot["Snapshot builder<br/>[snapshot.rs]"]
  node_collector_state["Collector state<br/>[state.rs]"]
  node_collector_modules["Metric pollers<br/>[mod.rs]"]
  node_gpu_polling["GPU polling<br/>[gpu.rs]"]
end

subgraph group_hardware["Hardware support"]
  node_nvidia["NVIDIA telemetry<br/>[nvidia.rs]"]
  node_hardware_profile["Hardware detection<br/>[hardware.rs]"]
  node_pdh["Windows PDH counters<br/>[pdh.rs]"]
end

node_user(("User"))

node_user -->|"views"| node_app
node_app -->|"subscribes to metrics"| node_metrics_hook
node_app -->|"loads settings"| node_settings_hook
node_app -->|"loads profile"| node_hardware_hook
node_app -->|"renders cards"| node_card_render
node_app -->|"renders sidebar"| node_hardware_sidebar
node_card_render -->|"creates cards"| node_metric_card
node_metric_card -->|"renders chart"| node_metric_chart
node_metrics_hook -->|"uses contracts"| node_metric_types
node_metrics_hook -->|"starts simulator"| node_mock_backend
node_metrics_hook -->|"invokes commands"| node_tauri_commands
node_hardware_hook -->|"loads profile"| node_tauri_commands
node_settings_hook -->|"persists settings"| node_settings_store
node_settings_hook -->|"uses simulated persistence"| node_mock_backend
node_supervisor -->|"runs loop"| node_run_loop
node_run_loop -->|"builds snapshots"| node_snapshot
node_run_loop -->|"updates collection state"| node_collector_state
node_run_loop -->|"polls metrics"| node_collector_modules
node_collector_modules -->|"dispatches GPU polls"| node_gpu_polling
node_collector_modules -->|"uses NVIDIA telemetry"| node_nvidia
node_snapshot -->|"uses hardware profile"| node_hardware_profile
node_collector_state -->|"stores profile"| node_hardware_profile
node_collector_state -->|"holds counter handles"| node_pdh
node_hardware_profile -->|"uses counter handles"| node_pdh

click node_app "https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src/App.tsx"
click node_card_render "https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src/cards/renderCardContent.tsx"
click node_metric_card "https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src/components/MetricCard.tsx"
click node_metric_chart "https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src/components/MetricChart.tsx"
click node_hardware_sidebar "https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src/components/HardwareSidebar.tsx"
click node_settings_hook "https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src/hooks/useSettings.ts"
click node_metrics_hook "https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src/hooks/useMetrics.ts"
click node_hardware_hook "https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src/hooks/useHardwareProfile.ts"
click node_mock_backend "https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src/sim/mockBackend.ts"
click node_metric_types "https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src/types/metrics.ts"
click node_tauri_commands "https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src-tauri/src/main.rs"
click node_run_loop "https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src-tauri/src/collector/run_loop.rs"
click node_supervisor "https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src-tauri/src/collector/supervisor.rs"
click node_snapshot "https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src-tauri/src/collector/snapshot.rs"
click node_collector_state "https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src-tauri/src/state.rs"
click node_collector_modules "https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src-tauri/src/collector/mod.rs"
click node_gpu_polling "https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src-tauri/src/collector/gpu.rs"
click node_nvidia "https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src-tauri/src/collector/nvidia.rs"
click node_hardware_profile "https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src-tauri/src/hardware.rs"
click node_pdh "https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src-tauri/src/pdh.rs"

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_app,node_card_render,node_metric_card,node_metric_chart,node_hardware_sidebar,node_user toneBlue
class node_settings_hook,node_settings_store,node_metrics_hook,node_hardware_hook,node_mock_backend,node_metric_types toneAmber
class node_tauri_commands,node_run_loop,node_supervisor,node_snapshot,node_collector_state,node_collector_modules,node_gpu_polling toneMint
class node_nvidia,node_hardware_profile,node_pdh toneRose
```

## Components

### Dashboard UI

- [Dashboard app](https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src/App.tsx): `sys-monitor-tauri/src/App.tsx`
- [Card rendering](https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src/cards/renderCardContent.tsx): `sys-monitor-tauri/src/cards/renderCardContent.tsx`
- [Metric cards](https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src/components/MetricCard.tsx): `sys-monitor-tauri/src/components/MetricCard.tsx`
- [Metric charts](https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src/components/MetricChart.tsx): `sys-monitor-tauri/src/components/MetricChart.tsx`
- [Hardware sidebar](https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src/components/HardwareSidebar.tsx): `sys-monitor-tauri/src/components/HardwareSidebar.tsx`

### Frontend data

- [Settings](https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src/hooks/useSettings.ts): `sys-monitor-tauri/src/hooks/useSettings.ts`
- **Settings store**
- [Metrics subscription](https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src/hooks/useMetrics.ts): `sys-monitor-tauri/src/hooks/useMetrics.ts`
- [Hardware profile hook](https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src/hooks/useHardwareProfile.ts): `sys-monitor-tauri/src/hooks/useHardwareProfile.ts`
- [Browser simulator](https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src/sim/mockBackend.ts): `sys-monitor-tauri/src/sim/mockBackend.ts`
- [Metric contracts](https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src/types/metrics.ts): `sys-monitor-tauri/src/types/metrics.ts`

### Metric collection

- [Tauri commands](https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src-tauri/src/main.rs): `sys-monitor-tauri/src-tauri/src/main.rs`
- [Collector tick loop](https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src-tauri/src/collector/run_loop.rs): `sys-monitor-tauri/src-tauri/src/collector/run_loop.rs`
- [Collector supervisor](https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src-tauri/src/collector/supervisor.rs): `sys-monitor-tauri/src-tauri/src/collector/supervisor.rs`
- [Snapshot builder](https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src-tauri/src/collector/snapshot.rs): `sys-monitor-tauri/src-tauri/src/collector/snapshot.rs`
- [Collector state](https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src-tauri/src/state.rs): `sys-monitor-tauri/src-tauri/src/state.rs`
- [Metric pollers](https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src-tauri/src/collector/mod.rs): `sys-monitor-tauri/src-tauri/src/collector/mod.rs`
- [GPU polling](https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src-tauri/src/collector/gpu.rs): `sys-monitor-tauri/src-tauri/src/collector/gpu.rs`

### Hardware support

- [NVIDIA telemetry](https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src-tauri/src/collector/nvidia.rs): `sys-monitor-tauri/src-tauri/src/collector/nvidia.rs`
- [Hardware detection](https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src-tauri/src/hardware.rs): `sys-monitor-tauri/src-tauri/src/hardware.rs`
- [Windows PDH counters](https://github.com/quantdale/monitorers/blob/main/sys-monitor-tauri/src-tauri/src/pdh.rs): `sys-monitor-tauri/src-tauri/src/pdh.rs`

### Other components

- **User**

## Connections

- User → Dashboard app: views (evidence: `sys-monitor-tauri/src/App.tsx`)
- Dashboard app → Metrics subscription: subscribes to metrics (evidence: `sys-monitor-tauri/src/App.tsx`)
- Dashboard app → Settings: loads settings (evidence: `sys-monitor-tauri/src/App.tsx`)
- Dashboard app → Hardware profile hook: loads profile (evidence: `sys-monitor-tauri/src/App.tsx`)
- Dashboard app → Card rendering: renders cards (evidence: `sys-monitor-tauri/src/App.tsx`)
- Dashboard app → Hardware sidebar: renders sidebar (evidence: `sys-monitor-tauri/src/App.tsx`)
- Card rendering → Metric cards: creates cards (evidence: `sys-monitor-tauri/src/cards/renderCardContent.tsx`)
- Metric cards → Metric charts: renders chart (evidence: `sys-monitor-tauri/src/components/MetricCard.tsx`)
- Metrics subscription → Metric contracts: uses contracts (evidence: `sys-monitor-tauri/src/hooks/useMetrics.ts`)
- Metrics subscription → Browser simulator: starts simulator (evidence: `sys-monitor-tauri/src/hooks/useMetrics.ts`)
- Metrics subscription → Tauri commands: invokes commands (evidence: `sys-monitor-tauri/src/hooks/useMetrics.ts`)
- Hardware profile hook → Tauri commands: loads profile (evidence: `sys-monitor-tauri/src/hooks/useHardwareProfile.ts`)
- Settings → Settings store: persists settings (evidence: `sys-monitor-tauri/src/hooks/useSettings.ts`)
- Settings → Browser simulator: uses simulated persistence (evidence: `sys-monitor-tauri/src/hooks/useSettings.ts`)
- Collector supervisor → Collector tick loop: runs loop (evidence: `sys-monitor-tauri/src-tauri/src/collector/supervisor.rs`)
- Collector tick loop → Snapshot builder: builds snapshots (evidence: `sys-monitor-tauri/src-tauri/src/collector/run_loop.rs`)
- Collector tick loop → Collector state: updates collection state (evidence: `sys-monitor-tauri/src-tauri/src/collector/run_loop.rs`)
- Collector tick loop → Metric pollers: polls metrics (evidence: `sys-monitor-tauri/src-tauri/src/collector/run_loop.rs`)
- Metric pollers → GPU polling: dispatches GPU polls (evidence: `sys-monitor-tauri/src-tauri/src/collector/mod.rs`)
- Metric pollers → NVIDIA telemetry: uses NVIDIA telemetry (evidence: `sys-monitor-tauri/src-tauri/src/collector/mod.rs`)
- Snapshot builder → Hardware detection: uses hardware profile (evidence: `sys-monitor-tauri/src-tauri/src/collector/snapshot.rs`)
- Collector state → Hardware detection: stores profile (evidence: `sys-monitor-tauri/src-tauri/src/state.rs`)
- Collector state → Windows PDH counters: holds counter handles (evidence: `sys-monitor-tauri/src-tauri/src/state.rs`)
- Hardware detection → Windows PDH counters: uses counter handles (evidence: `sys-monitor-tauri/src-tauri/src/hardware.rs`)
