# crazy-vincnet/macoptimizationtool architecture

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

- Interactive diagram: https://gitdiagram.com/crazy-vincnet/macoptimizationtool
- Repository: https://github.com/crazy-vincnet/macoptimizationtool

## Overview

Mac Clean Optimizer is a macOS system-maintenance app. Users enter through the main window, choose a tool, scan or inspect system data, then review results and perform an action such as cleanup, deletion, or settings changes. Its major capabilities also include resource monitoring, startup-item management, browser privacy cleanup, and verified in-app updates. The README and source index establish the product boundaries and several connections; unsampled implementation details are represented only where documented, so some links are omitted rather than inferred.

Main entry points: [`Sources/MacOptimizationTool/MainView.swift`](https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/MainView.swift) (Main Navigation), [`Sources/MacOptimizationTool/DuplicateViewModel.swift`](https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/DuplicateViewModel.swift) (Duplicate Scanner), [`Sources/MacOptimizationCore/FileSafety.swift`](https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationCore/FileSafety.swift) (Safe File Operations), [`Sources/MacOptimizationCore/DirectorySize.swift`](https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationCore/DirectorySize.swift) (Directory Measurement)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App Shell"]
  node_app["App Lifecycle<br/>[App.swift]"]
  node_main["Main Navigation<br/>[MainView.swift]"]
  node_permissions["Permission Onboarding"]
  node_startup["Startup Manager"]
end

subgraph group_cleanup["Cleanup Tools"]
  node_diskclean["Disk Cleanup"]
  node_diskview["Cleanup Interface"]
  node_duplicates["Duplicate Scanner"]
  node_largefiles["Large File Scanner"]
  node_downloads["Stale Downloads"]
  node_privacy["Privacy Cleaner"]
  node_uninstaller["App Uninstaller"]
  node_maintenance["Disk Map &amp; Maintenance"]
end

subgraph group_monitor["Monitoring"]
  node_dashboard["Resource Dashboard"]
  node_menu["Menu Bar Monitor"]
  node_guard["Process Guard"]
  node_diskhealth["Disk Health"]
end

subgraph group_services["Core Services"]
  node_filesafety["Safe File Operations<br/>[FileSafety.swift]"]
  node_dirsize["Directory Measurement"]
  node_hardware["Hardware Telemetry"]
  node_translations["Localization"]
  node_generated["Translation Catalogs"]
  node_additional["Additional Catalog"]
  node_hashcache[("Hash Cache<br/>[HashCache.swift]")]
  node_identity["File Identity<br/>[FileIdentity.swift]"]
  node_exclusions["Scan Exclusions"]
  node_runner["System Process Runner"]
  node_verification["Update Verification"]
end

subgraph group_settings["Settings &amp; Updates"]
  node_settings["Settings"]
  node_updater["Verified Updater"]
end

node_user(("Mac User"))
node_external(("macOS Services"))

node_user -->|"launches"| node_app
node_app -->|"shows window"| node_main
node_app -->|"starts monitor"| node_menu
node_app -->|"starts guard"| node_guard
node_main -->|"checks access"| node_permissions
node_main -->|"routes to"| node_dashboard
node_main -->|"routes to"| node_diskclean
node_main -->|"routes to"| node_duplicates
node_main -->|"routes to"| node_largefiles
node_main -->|"routes to"| node_downloads
node_main -->|"routes to"| node_privacy
node_main -->|"routes to"| node_uninstaller
node_main -->|"routes to"| node_startup
node_main -->|"routes to"| node_diskhealth
node_main -->|"routes to"| node_maintenance
node_main -->|"routes to"| node_settings
node_dashboard -->|"reads telemetry"| node_hardware
node_menu -->|"reads telemetry"| node_hardware
node_menu -->|"runs purge"| node_runner
node_guard -->|"inspects processes"| node_external
node_diskclean -->|"measures targets"| node_dirsize
node_diskclean -->|"deletes safely"| node_filesafety
node_diskview -->|"uses model"| node_diskclean
node_duplicates -->|"uses cache"| node_hashcache
node_duplicates -->|"filters scans"| node_exclusions
node_duplicates -->|"checks identity"| node_identity
node_duplicates -->|"deletes safely"| node_filesafety
node_uninstaller -->|"deletes safely"| node_filesafety
node_uninstaller -->|"measures leftovers"| node_dirsize
node_uninstaller -->|"matches leftovers"| node_external
node_startup -->|"trashes items"| node_filesafety
node_settings -->|"sets language"| node_translations
node_settings -->|"checks updates"| node_updater
node_updater -->|"verifies download"| node_verification
node_updater -->|"fetches release"| node_external
node_updater -->|"mounts verified image"| node_external
node_translations -->|"loads catalog"| node_generated
node_translations -->|"loads catalog"| node_additional
node_permissions -->|"checks TCC access"| node_external
node_privacy -.->|"measures targets"| node_dirsize
node_downloads -.->|"measures targets"| node_dirsize
node_largefiles -.->|"deletes safely"| node_filesafety
node_diskhealth -.->|"reads disk health"| node_external
node_maintenance -.->|"maps disk usage"| node_dirsize

click node_app "https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/App.swift"
click node_main "https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/MainView.swift"
click node_permissions "https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/PermissionManager.swift"
click node_dashboard "https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/DashboardView.swift"
click node_menu "https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/MenuBarManager.swift"
click node_guard "https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/ProcessGuardManager.swift"
click node_diskclean "https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/DiskCleanViewModel.swift"
click node_diskview "https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/DiskCleanerView.swift"
click node_duplicates "https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/DuplicateViewModel.swift"
click node_largefiles "https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/LargeFilesViewModel.swift"
click node_downloads "https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/OldDownloadsViewModel.swift"
click node_privacy "https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/PrivacyCleanerViewModel.swift"
click node_uninstaller "https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/UninstallerViewModel.swift"
click node_startup "https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/StartupManagerViewModel.swift"
click node_diskhealth "https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/DiskHealthViewModel.swift"
click node_maintenance "https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/MaintenanceViewModel.swift"
click node_filesafety "https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationCore/FileSafety.swift"
click node_dirsize "https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationCore/DirectorySize.swift"
click node_hardware "https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationCore/HardwareStatsHelper.swift"
click node_translations "https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationCore/LanguageManager.swift"
click node_generated "https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationCore/GeneratedTranslations.swift"
click node_additional "https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationCore/AdditionalTranslations.swift"
click node_hashcache "https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationCore/HashCache.swift"
click node_identity "https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationCore/FileIdentity.swift"
click node_exclusions "https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationCore/ScanExclusion.swift"
click node_runner "https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationCore/SystemProcessRunner.swift"
click node_settings "https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/SettingsViewModel.swift"
click node_updater "https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/SparkleUpdaterManager.swift"
click node_verification "https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationCore/UpdateVerification.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_main,node_permissions,node_startup,node_user toneBlue
class node_diskclean,node_diskview,node_duplicates,node_largefiles,node_downloads,node_privacy,node_uninstaller,node_maintenance toneAmber
class node_dashboard,node_menu,node_guard,node_diskhealth toneMint
class node_filesafety,node_dirsize,node_hardware,node_translations,node_generated,node_additional,node_hashcache,node_identity,node_exclusions,node_runner,node_verification toneRose
class node_settings,node_updater,node_external toneIndigo
```

## Components

### App Shell

- [App Lifecycle](https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/App.swift): `Sources/MacOptimizationTool/App.swift`
- [Main Navigation](https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/MainView.swift): `Sources/MacOptimizationTool/MainView.swift`
- [Permission Onboarding](https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/PermissionManager.swift): `Sources/MacOptimizationTool/PermissionManager.swift`
- [Startup Manager](https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/StartupManagerViewModel.swift): `Sources/MacOptimizationTool/StartupManagerViewModel.swift`

### Cleanup Tools

- [Disk Cleanup](https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/DiskCleanViewModel.swift): `Sources/MacOptimizationTool/DiskCleanViewModel.swift`
- [Cleanup Interface](https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/DiskCleanerView.swift): `Sources/MacOptimizationTool/DiskCleanerView.swift`
- [Duplicate Scanner](https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/DuplicateViewModel.swift): `Sources/MacOptimizationTool/DuplicateViewModel.swift`
- [Large File Scanner](https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/LargeFilesViewModel.swift): `Sources/MacOptimizationTool/LargeFilesViewModel.swift`
- [Stale Downloads](https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/OldDownloadsViewModel.swift): `Sources/MacOptimizationTool/OldDownloadsViewModel.swift`
- [Privacy Cleaner](https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/PrivacyCleanerViewModel.swift): `Sources/MacOptimizationTool/PrivacyCleanerViewModel.swift`
- [App Uninstaller](https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/UninstallerViewModel.swift): `Sources/MacOptimizationTool/UninstallerViewModel.swift`
- [Disk Map & Maintenance](https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/MaintenanceViewModel.swift): `Sources/MacOptimizationTool/MaintenanceViewModel.swift`

### Monitoring

- [Resource Dashboard](https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/DashboardView.swift): `Sources/MacOptimizationTool/DashboardView.swift`
- [Menu Bar Monitor](https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/MenuBarManager.swift): `Sources/MacOptimizationTool/MenuBarManager.swift`
- [Process Guard](https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/ProcessGuardManager.swift): `Sources/MacOptimizationTool/ProcessGuardManager.swift`
- [Disk Health](https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/DiskHealthViewModel.swift): `Sources/MacOptimizationTool/DiskHealthViewModel.swift`

### Core Services

- [Safe File Operations](https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationCore/FileSafety.swift): `Sources/MacOptimizationCore/FileSafety.swift`
- [Directory Measurement](https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationCore/DirectorySize.swift): `Sources/MacOptimizationCore/DirectorySize.swift`
- [Hardware Telemetry](https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationCore/HardwareStatsHelper.swift): `Sources/MacOptimizationCore/HardwareStatsHelper.swift`
- [Localization](https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationCore/LanguageManager.swift): `Sources/MacOptimizationCore/LanguageManager.swift`
- [Translation Catalogs](https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationCore/GeneratedTranslations.swift): `Sources/MacOptimizationCore/GeneratedTranslations.swift`
- [Additional Catalog](https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationCore/AdditionalTranslations.swift): `Sources/MacOptimizationCore/AdditionalTranslations.swift`
- [Hash Cache](https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationCore/HashCache.swift): `Sources/MacOptimizationCore/HashCache.swift`
- [File Identity](https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationCore/FileIdentity.swift): `Sources/MacOptimizationCore/FileIdentity.swift`
- [Scan Exclusions](https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationCore/ScanExclusion.swift): `Sources/MacOptimizationCore/ScanExclusion.swift`
- [System Process Runner](https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationCore/SystemProcessRunner.swift): `Sources/MacOptimizationCore/SystemProcessRunner.swift`
- [Update Verification](https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationCore/UpdateVerification.swift): `Sources/MacOptimizationCore/UpdateVerification.swift`

### Settings & Updates

- [Settings](https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/SettingsViewModel.swift): `Sources/MacOptimizationTool/SettingsViewModel.swift`
- [Verified Updater](https://github.com/crazy-vincnet/macoptimizationtool/blob/main/Sources/MacOptimizationTool/SparkleUpdaterManager.swift): `Sources/MacOptimizationTool/SparkleUpdaterManager.swift`

### Other components

- **Mac User**
- **macOS Services**

## Connections

- Mac User → App Lifecycle: launches (evidence: `Sources/MacOptimizationTool/App.swift`)
- App Lifecycle → Main Navigation: shows window (evidence: `Sources/MacOptimizationTool/App.swift`)
- App Lifecycle → Menu Bar Monitor: starts monitor (evidence: `Sources/MacOptimizationTool/App.swift`)
- App Lifecycle → Process Guard: starts guard (evidence: `Sources/MacOptimizationTool/App.swift`)
- Main Navigation → Permission Onboarding: checks access (evidence: `Sources/MacOptimizationTool/MainView.swift`)
- Main Navigation → Resource Dashboard: routes to (evidence: `Sources/MacOptimizationTool/MainView.swift`)
- Main Navigation → Disk Cleanup: routes to (evidence: `Sources/MacOptimizationTool/MainView.swift`)
- Main Navigation → Duplicate Scanner: routes to (evidence: `Sources/MacOptimizationTool/MainView.swift`)
- Main Navigation → Large File Scanner: routes to (evidence: `Sources/MacOptimizationTool/MainView.swift`)
- Main Navigation → Stale Downloads: routes to (evidence: `Sources/MacOptimizationTool/MainView.swift`)
- Main Navigation → Privacy Cleaner: routes to (evidence: `Sources/MacOptimizationTool/MainView.swift`)
- Main Navigation → App Uninstaller: routes to (evidence: `Sources/MacOptimizationTool/MainView.swift`)
- Main Navigation → Startup Manager: routes to (evidence: `Sources/MacOptimizationTool/MainView.swift`)
- Main Navigation → Disk Health: routes to (evidence: `Sources/MacOptimizationTool/MainView.swift`)
- Main Navigation → Disk Map & Maintenance: routes to (evidence: `Sources/MacOptimizationTool/MainView.swift`)
- Main Navigation → Settings: routes to (evidence: `Sources/MacOptimizationTool/MainView.swift`)
- Resource Dashboard → Hardware Telemetry: reads telemetry (evidence: `Sources/MacOptimizationTool/DashboardView.swift`)
- Menu Bar Monitor → Hardware Telemetry: reads telemetry (evidence: `Sources/MacOptimizationTool/MenuBarManager.swift`)
- Menu Bar Monitor → System Process Runner: runs purge (evidence: `Sources/MacOptimizationTool/MenuBarManager.swift`)
- Process Guard → macOS Services: inspects processes (evidence: `Sources/MacOptimizationTool/ProcessGuardManager.swift`)
- Disk Cleanup → Directory Measurement: measures targets (evidence: `Sources/MacOptimizationTool/DiskCleanViewModel.swift`)
- Disk Cleanup → Safe File Operations: deletes safely (evidence: `Sources/MacOptimizationTool/DiskCleanViewModel.swift`)
- Cleanup Interface → Disk Cleanup: uses model (evidence: `Sources/MacOptimizationTool/DiskCleanerView.swift`)
- Duplicate Scanner → Hash Cache: uses cache (evidence: `Sources/MacOptimizationTool/DuplicateViewModel.swift`)
- Duplicate Scanner → Scan Exclusions: filters scans (evidence: `Sources/MacOptimizationTool/DuplicateViewModel.swift`)
- Duplicate Scanner → File Identity: checks identity (evidence: `Sources/MacOptimizationTool/DuplicateViewModel.swift`)
- Duplicate Scanner → Safe File Operations: deletes safely (evidence: `Sources/MacOptimizationTool/DuplicateViewModel.swift`)
- App Uninstaller → Safe File Operations: deletes safely (evidence: `Sources/MacOptimizationTool/UninstallerViewModel.swift`)
- App Uninstaller → Directory Measurement: measures leftovers (evidence: `Sources/MacOptimizationTool/UninstallerViewModel.swift`)
- App Uninstaller → macOS Services: matches leftovers (evidence: `Sources/MacOptimizationTool/UninstallerViewModel.swift`)
- Startup Manager → Safe File Operations: trashes items (evidence: `Sources/MacOptimizationTool/StartupManagerViewModel.swift`)
- Settings → Localization: sets language (evidence: `Sources/MacOptimizationTool/SettingsViewModel.swift`)
- Settings → Verified Updater: checks updates (evidence: `Sources/MacOptimizationTool/SettingsViewModel.swift`)
- Verified Updater → Update Verification: verifies download (evidence: `Sources/MacOptimizationTool/SparkleUpdaterManager.swift`)
- Verified Updater → macOS Services: fetches release (evidence: `README.md`)
- Verified Updater → macOS Services: mounts verified image (evidence: `Sources/MacOptimizationTool/SparkleUpdaterManager.swift`)
- Localization → Translation Catalogs: loads catalog (evidence: `Sources/MacOptimizationCore/LanguageManager.swift`)
- Localization → Additional Catalog: loads catalog (evidence: `Sources/MacOptimizationCore/LanguageManager.swift`)
- Permission Onboarding → macOS Services: checks TCC access (evidence: `README.md`)
- Privacy Cleaner → Directory Measurement: measures targets
- Stale Downloads → Directory Measurement: measures targets
- Large File Scanner → Safe File Operations: deletes safely
- Disk Health → macOS Services: reads disk health
- Disk Map & Maintenance → Directory Measurement: maps disk usage
