# matthewmyrick/ios-monitor architecture

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

- Interactive diagram: https://gitdiagram.com/matthewmyrick/ios-monitor
- Repository: https://github.com/matthewmyrick/ios-monitor

## Overview

iOS Monitor is a sandboxed iPhone system-monitoring app, not a cross-process task manager. The user opens a SwiftUI dashboard; its view model samples device-wide CPU, memory, network, and device information, assembles a snapshot, and the dashboard formats and displays it. The README also documents self-only CPU and memory measurements, battery, thermal, storage, and GPU identity. Source excerpts show the sampling and rendering path; documented metric sources support the links to iOS system APIs.

Main entry points: [`iOSMonitor/ViewModel/MonitorViewModel.swift`](https://github.com/matthewmyrick/ios-monitor/blob/claude/ios-system-monitor-fg3cz2/iOSMonitor/ViewModel/MonitorViewModel.swift) (Sampling view model), [`iOSMonitor/Views/DashboardView.swift`](https://github.com/matthewmyrick/ios-monitor/blob/claude/ios-system-monitor-fg3cz2/iOSMonitor/Views/DashboardView.swift) (Live dashboard), [`iOSMonitor/App/iOSMonitorApp.swift`](https://github.com/matthewmyrick/ios-monitor/blob/claude/ios-system-monitor-fg3cz2/iOSMonitor/App/iOSMonitorApp.swift) (iOS Monitor app), [`iOSMonitor/Metrics/CPUMonitor.swift`](https://github.com/matthewmyrick/ios-monitor/blob/claude/ios-system-monitor-fg3cz2/iOSMonitor/Metrics/CPUMonitor.swift) (CPU monitor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App entry"]
  node_app["iOS Monitor app"]
end

subgraph group_sampling["Metric sampling"]
  node_viewmodel["Sampling view model"]
  node_cpu["CPU monitor<br/>[CPUMonitor.swift]"]
  node_memory["Memory monitor"]
  node_network["Network monitor"]
  node_device["Device monitor"]
end

subgraph group_data["Snapshot and formatting"]
  node_stats["System snapshot<br/>[SystemStats.swift]"]
  node_format["Display formatters<br/>[Formatters.swift]"]
end

subgraph group_interface["Dashboard UI"]
  node_dashboard["Live dashboard"]
  node_components["UI components<br/>[Components.swift]"]
end

node_user(("User"))
node_system["iOS system APIs"]

node_user -->|"opens"| node_app
node_app -->|"launches"| node_dashboard
node_dashboard -->|"starts sampling"| node_viewmodel
node_viewmodel -->|"samples"| node_cpu
node_viewmodel -->|"reads"| node_memory
node_viewmodel -->|"samples"| node_network
node_viewmodel -->|"reads"| node_device
node_viewmodel -->|"updates"| node_stats
node_dashboard -->|"displays"| node_stats
node_dashboard -->|"uses"| node_components
node_dashboard -->|"formats values"| node_format
node_components -->|"formats values"| node_format
node_cpu -->|"reads Mach counters"| node_system
node_memory -->|"reads Mach memory"| node_system
node_network -->|"reads interface counters"| node_system
node_device -->|"reads device APIs"| node_system

click node_app "https://github.com/matthewmyrick/ios-monitor/blob/claude/ios-system-monitor-fg3cz2/iOSMonitor/App/iOSMonitorApp.swift"
click node_dashboard "https://github.com/matthewmyrick/ios-monitor/blob/claude/ios-system-monitor-fg3cz2/iOSMonitor/Views/DashboardView.swift"
click node_components "https://github.com/matthewmyrick/ios-monitor/blob/claude/ios-system-monitor-fg3cz2/iOSMonitor/Views/Components.swift"
click node_viewmodel "https://github.com/matthewmyrick/ios-monitor/blob/claude/ios-system-monitor-fg3cz2/iOSMonitor/ViewModel/MonitorViewModel.swift"
click node_cpu "https://github.com/matthewmyrick/ios-monitor/blob/claude/ios-system-monitor-fg3cz2/iOSMonitor/Metrics/CPUMonitor.swift"
click node_memory "https://github.com/matthewmyrick/ios-monitor/blob/claude/ios-system-monitor-fg3cz2/iOSMonitor/Metrics/MemoryMonitor.swift"
click node_network "https://github.com/matthewmyrick/ios-monitor/blob/claude/ios-system-monitor-fg3cz2/iOSMonitor/Metrics/NetworkMonitor.swift"
click node_device "https://github.com/matthewmyrick/ios-monitor/blob/claude/ios-system-monitor-fg3cz2/iOSMonitor/Metrics/DeviceMonitor.swift"
click node_stats "https://github.com/matthewmyrick/ios-monitor/blob/claude/ios-system-monitor-fg3cz2/iOSMonitor/Model/SystemStats.swift"
click node_format "https://github.com/matthewmyrick/ios-monitor/blob/claude/ios-system-monitor-fg3cz2/iOSMonitor/Model/Formatters.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_app,node_user toneBlue
class node_viewmodel,node_cpu,node_memory,node_network,node_device toneAmber
class node_stats,node_format,node_system toneMint
class node_dashboard,node_components toneRose
```

## Components

### App entry

- [iOS Monitor app](https://github.com/matthewmyrick/ios-monitor/blob/claude/ios-system-monitor-fg3cz2/iOSMonitor/App/iOSMonitorApp.swift): `iOSMonitor/App/iOSMonitorApp.swift`

### Metric sampling

- [Sampling view model](https://github.com/matthewmyrick/ios-monitor/blob/claude/ios-system-monitor-fg3cz2/iOSMonitor/ViewModel/MonitorViewModel.swift): `iOSMonitor/ViewModel/MonitorViewModel.swift`
- [CPU monitor](https://github.com/matthewmyrick/ios-monitor/blob/claude/ios-system-monitor-fg3cz2/iOSMonitor/Metrics/CPUMonitor.swift): `iOSMonitor/Metrics/CPUMonitor.swift`
- [Memory monitor](https://github.com/matthewmyrick/ios-monitor/blob/claude/ios-system-monitor-fg3cz2/iOSMonitor/Metrics/MemoryMonitor.swift): `iOSMonitor/Metrics/MemoryMonitor.swift`
- [Network monitor](https://github.com/matthewmyrick/ios-monitor/blob/claude/ios-system-monitor-fg3cz2/iOSMonitor/Metrics/NetworkMonitor.swift): `iOSMonitor/Metrics/NetworkMonitor.swift`
- [Device monitor](https://github.com/matthewmyrick/ios-monitor/blob/claude/ios-system-monitor-fg3cz2/iOSMonitor/Metrics/DeviceMonitor.swift): `iOSMonitor/Metrics/DeviceMonitor.swift`

### Snapshot and formatting

- [System snapshot](https://github.com/matthewmyrick/ios-monitor/blob/claude/ios-system-monitor-fg3cz2/iOSMonitor/Model/SystemStats.swift): `iOSMonitor/Model/SystemStats.swift`
- [Display formatters](https://github.com/matthewmyrick/ios-monitor/blob/claude/ios-system-monitor-fg3cz2/iOSMonitor/Model/Formatters.swift): `iOSMonitor/Model/Formatters.swift`

### Dashboard UI

- [Live dashboard](https://github.com/matthewmyrick/ios-monitor/blob/claude/ios-system-monitor-fg3cz2/iOSMonitor/Views/DashboardView.swift): `iOSMonitor/Views/DashboardView.swift`
- [UI components](https://github.com/matthewmyrick/ios-monitor/blob/claude/ios-system-monitor-fg3cz2/iOSMonitor/Views/Components.swift): `iOSMonitor/Views/Components.swift`

### Other components

- **User**
- **iOS system APIs**

## Connections

- User → iOS Monitor app: opens
- iOS Monitor app → Live dashboard: launches (evidence: `iOSMonitor/App/iOSMonitorApp.swift`)
- Live dashboard → Sampling view model: starts sampling (evidence: `iOSMonitor/Views/DashboardView.swift`)
- Sampling view model → CPU monitor: samples (evidence: `iOSMonitor/ViewModel/MonitorViewModel.swift`)
- Sampling view model → Memory monitor: reads (evidence: `iOSMonitor/ViewModel/MonitorViewModel.swift`)
- Sampling view model → Network monitor: samples (evidence: `iOSMonitor/ViewModel/MonitorViewModel.swift`)
- Sampling view model → Device monitor: reads (evidence: `iOSMonitor/ViewModel/MonitorViewModel.swift`)
- Sampling view model → System snapshot: updates (evidence: `iOSMonitor/ViewModel/MonitorViewModel.swift`)
- Live dashboard → System snapshot: displays (evidence: `iOSMonitor/Views/DashboardView.swift`)
- Live dashboard → UI components: uses (evidence: `iOSMonitor/Views/DashboardView.swift`)
- Live dashboard → Display formatters: formats values (evidence: `iOSMonitor/Views/DashboardView.swift`)
- UI components → Display formatters: formats values (evidence: `iOSMonitor/Views/Components.swift`)
- CPU monitor → iOS system APIs: reads Mach counters (evidence: `iOSMonitor/Metrics/CPUMonitor.swift`)
- Memory monitor → iOS system APIs: reads Mach memory (evidence: `iOSMonitor/Metrics/MemoryMonitor.swift`)
- Network monitor → iOS system APIs: reads interface counters (evidence: `iOSMonitor/Metrics/NetworkMonitor.swift`)
- Device monitor → iOS system APIs: reads device APIs (evidence: `iOSMonitor/Metrics/DeviceMonitor.swift`)
