# htmnsrc/syscleanx architecture

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

- Interactive diagram: https://gitdiagram.com/htmnsrc/syscleanx
- Repository: https://github.com/htmnsrc/syscleanx

## Overview

SysCleanX is a Windows PC-cleaning desktop app. Users choose a tool in the GUI, inspect results, then confirm cleanup or another action; the clean path is orchestrated by the core engine, which resolves targets and performs guarded filesystem work. Other branches cover uninstall and leftovers, startup management, debloating, repair, disk usage, duplicates, and settings. GUI-to-core links beyond the sampled clean engine are documented capabilities, not verified calls; those links are dashed. The available excerpts do not establish every feature’s internal wiring.

Main entry points: [`crates/gui/src/app.rs`](https://github.com/htmnsrc/syscleanx/blob/main/crates/gui/src/app.rs) (App shell), [`crates/core/src/engine.rs`](https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/engine.rs) (Scan and clean), [`crates/core/src/fsops.rs`](https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/fsops.rs) (Filesystem walker), [`crates/core/src/broken.rs`](https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/broken.rs) (Broken-item repair)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_gui["Desktop interface"]
  node_app["App shell<br/>[app.rs]"]
  node_jobs["Background jobs<br/>[job.rs]"]
  node_clean_page["Clean page<br/>[cleaner.rs]"]
  node_apps_page["Programs page<br/>[uninstaller.rs]"]
  node_startup_page["Startup page<br/>[startup.rs]"]
  node_debloat_page["Debloat page<br/>[debloat.rs]"]
  node_repair_page["Repair page<br/>[repair.rs]"]
  node_disk_page["Disk explorer<br/>[disk.rs]"]
  node_duplicates_page["Duplicate finder<br/>[duplicates.rs]"]
  node_settings_page["Settings page<br/>[settings.rs]"]
  node_shared["Shared UI state<br/>[shared.rs]"]
  node_theme["Theme system<br/>[theme.rs]"]
end

subgraph group_clean["Cleaning core"]
  node_engine["Scan and clean<br/>[engine.rs]"]
  node_targets["Cleaning targets<br/>[targets.rs]"]
  node_resolve["Target resolution<br/>[resolve.rs]"]
  node_filesystem["Filesystem walker<br/>[fsops.rs]"]
  node_guard["Safety guard<br/>[guard.rs]"]
  node_paths["Path resolution<br/>[paths.rs]"]
end

subgraph group_maintenance["PC maintenance"]
  node_uninstall["Program removal<br/>[uninstall.rs]"]
  node_startup["Startup entries<br/>[startup.rs]"]
  node_debloat["Store app removal<br/>[bloat.rs]"]
  node_repair["Broken-item repair<br/>[broken.rs]"]
  node_diskusage["Disk usage scan<br/>[diskusage.rs]"]
  node_duplicates["Duplicate scan<br/>[duplicates.rs]"]
  node_special["Special cleanups<br/>[special.rs]"]
end

subgraph group_platform["Windows and state"]
  node_platform_api["Windows API layer<br/>[mod.rs]"]
  node_registry["Registry access<br/>[reg.rs]"]
  node_settings["Persistent settings<br/>[settings.rs]"]
  node_progress["Progress and cancel<br/>[progress.rs]"]
  node_logs["Deletion logs<br/>[log.rs]"]
end

node_user(("PC user"))

node_user -->|"opens"| node_app
node_app -->|"shows"| node_clean_page
node_app -->|"shows"| node_apps_page
node_app -->|"shows"| node_startup_page
node_app -->|"shows"| node_debloat_page
node_app -->|"shows"| node_repair_page
node_app -->|"shows"| node_disk_page
node_app -->|"shows"| node_duplicates_page
node_app -->|"shows"| node_settings_page
node_clean_page -.->|"requests scans"| node_engine
node_apps_page -.->|"manages programs"| node_uninstall
node_startup_page -.->|"manages entries"| node_startup
node_debloat_page -.->|"removes apps"| node_debloat
node_repair_page -.->|"repairs leftovers"| node_repair
node_disk_page -.->|"scans drives"| node_diskusage
node_duplicates_page -.->|"finds copies"| node_duplicates
node_settings_page -.->|"configures"| node_settings
node_app -->|"creates state"| node_shared
node_engine -->|"resolves targets"| node_resolve
node_engine -->|"uses definitions"| node_targets
node_engine -->|"scans and purges"| node_filesystem
node_engine -->|"checks paths"| node_guard
node_engine -->|"updates progress"| node_progress
node_engine -->|"records deletions"| node_logs
node_filesystem -->|"checks deletion"| node_guard
node_filesystem -->|"records results"| node_logs
node_resolve -->|"expands paths"| node_paths
node_uninstall -->|"reads registry"| node_registry
node_uninstall -->|"removes files"| node_filesystem
node_startup -->|"accesses entries"| node_registry
node_repair -->|"checks startup"| node_startup
node_repair -->|"checks leftovers"| node_uninstall
node_repair -->|"removes files"| node_filesystem
node_debloat -->|"uses system APIs"| node_platform_api
node_special -->|"uses Windows tools"| node_platform_api
node_special -->|"accesses registry"| node_registry
node_diskusage -->|"uses path helpers"| node_paths
node_duplicates -->|"uses path helpers"| node_paths

click node_app "https://github.com/htmnsrc/syscleanx/blob/main/crates/gui/src/app.rs"
click node_jobs "https://github.com/htmnsrc/syscleanx/blob/main/crates/gui/src/job.rs"
click node_clean_page "https://github.com/htmnsrc/syscleanx/blob/main/crates/gui/src/pages/cleaner.rs"
click node_apps_page "https://github.com/htmnsrc/syscleanx/blob/main/crates/gui/src/pages/uninstaller.rs"
click node_startup_page "https://github.com/htmnsrc/syscleanx/blob/main/crates/gui/src/pages/startup.rs"
click node_debloat_page "https://github.com/htmnsrc/syscleanx/blob/main/crates/gui/src/pages/debloat.rs"
click node_repair_page "https://github.com/htmnsrc/syscleanx/blob/main/crates/gui/src/pages/repair.rs"
click node_disk_page "https://github.com/htmnsrc/syscleanx/blob/main/crates/gui/src/pages/disk.rs"
click node_duplicates_page "https://github.com/htmnsrc/syscleanx/blob/main/crates/gui/src/pages/duplicates.rs"
click node_settings_page "https://github.com/htmnsrc/syscleanx/blob/main/crates/gui/src/pages/settings.rs"
click node_shared "https://github.com/htmnsrc/syscleanx/blob/main/crates/gui/src/shared.rs"
click node_theme "https://github.com/htmnsrc/syscleanx/blob/main/crates/gui/src/theme.rs"
click node_engine "https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/engine.rs"
click node_targets "https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/targets.rs"
click node_resolve "https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/resolve.rs"
click node_filesystem "https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/fsops.rs"
click node_guard "https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/guard.rs"
click node_paths "https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/paths.rs"
click node_uninstall "https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/uninstall.rs"
click node_startup "https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/startup.rs"
click node_debloat "https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/bloat.rs"
click node_repair "https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/broken.rs"
click node_diskusage "https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/diskusage.rs"
click node_duplicates "https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/duplicates.rs"
click node_special "https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/special.rs"
click node_platform_api "https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/sys/mod.rs"
click node_registry "https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/reg.rs"
click node_settings "https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/settings.rs"
click node_progress "https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/progress.rs"
click node_logs "https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/log.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_jobs,node_clean_page,node_apps_page,node_startup_page,node_debloat_page,node_repair_page,node_disk_page,node_duplicates_page,node_settings_page,node_shared,node_theme,node_user toneBlue
class node_engine,node_targets,node_resolve,node_filesystem,node_guard,node_paths toneAmber
class node_uninstall,node_startup,node_debloat,node_repair,node_diskusage,node_duplicates,node_special toneMint
class node_platform_api,node_registry,node_settings,node_progress,node_logs toneRose
```

## Components

### Desktop interface

- [App shell](https://github.com/htmnsrc/syscleanx/blob/main/crates/gui/src/app.rs): `crates/gui/src/app.rs`
- [Background jobs](https://github.com/htmnsrc/syscleanx/blob/main/crates/gui/src/job.rs): `crates/gui/src/job.rs`
- [Clean page](https://github.com/htmnsrc/syscleanx/blob/main/crates/gui/src/pages/cleaner.rs): `crates/gui/src/pages/cleaner.rs`
- [Programs page](https://github.com/htmnsrc/syscleanx/blob/main/crates/gui/src/pages/uninstaller.rs): `crates/gui/src/pages/uninstaller.rs`
- [Startup page](https://github.com/htmnsrc/syscleanx/blob/main/crates/gui/src/pages/startup.rs): `crates/gui/src/pages/startup.rs`
- [Debloat page](https://github.com/htmnsrc/syscleanx/blob/main/crates/gui/src/pages/debloat.rs): `crates/gui/src/pages/debloat.rs`
- [Repair page](https://github.com/htmnsrc/syscleanx/blob/main/crates/gui/src/pages/repair.rs): `crates/gui/src/pages/repair.rs`
- [Disk explorer](https://github.com/htmnsrc/syscleanx/blob/main/crates/gui/src/pages/disk.rs): `crates/gui/src/pages/disk.rs`
- [Duplicate finder](https://github.com/htmnsrc/syscleanx/blob/main/crates/gui/src/pages/duplicates.rs): `crates/gui/src/pages/duplicates.rs`
- [Settings page](https://github.com/htmnsrc/syscleanx/blob/main/crates/gui/src/pages/settings.rs): `crates/gui/src/pages/settings.rs`
- [Shared UI state](https://github.com/htmnsrc/syscleanx/blob/main/crates/gui/src/shared.rs): `crates/gui/src/shared.rs`
- [Theme system](https://github.com/htmnsrc/syscleanx/blob/main/crates/gui/src/theme.rs): `crates/gui/src/theme.rs`

### Cleaning core

- [Scan and clean](https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/engine.rs): `crates/core/src/engine.rs`
- [Cleaning targets](https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/targets.rs): `crates/core/src/targets.rs`
- [Target resolution](https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/resolve.rs): `crates/core/src/resolve.rs`
- [Filesystem walker](https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/fsops.rs): `crates/core/src/fsops.rs`
- [Safety guard](https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/guard.rs): `crates/core/src/guard.rs`
- [Path resolution](https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/paths.rs): `crates/core/src/paths.rs`

### PC maintenance

- [Program removal](https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/uninstall.rs): `crates/core/src/uninstall.rs`
- [Startup entries](https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/startup.rs): `crates/core/src/startup.rs`
- [Store app removal](https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/bloat.rs): `crates/core/src/bloat.rs`
- [Broken-item repair](https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/broken.rs): `crates/core/src/broken.rs`
- [Disk usage scan](https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/diskusage.rs): `crates/core/src/diskusage.rs`
- [Duplicate scan](https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/duplicates.rs): `crates/core/src/duplicates.rs`
- [Special cleanups](https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/special.rs): `crates/core/src/special.rs`

### Windows and state

- [Windows API layer](https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/sys/mod.rs): `crates/core/src/sys/mod.rs`
- [Registry access](https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/reg.rs): `crates/core/src/reg.rs`
- [Persistent settings](https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/settings.rs): `crates/core/src/settings.rs`
- [Progress and cancel](https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/progress.rs): `crates/core/src/progress.rs`
- [Deletion logs](https://github.com/htmnsrc/syscleanx/blob/main/crates/core/src/log.rs): `crates/core/src/log.rs`

### Other components

- **PC user**

## Connections

- PC user → App shell: opens (evidence: `README.md`)
- App shell → Clean page: shows (evidence: `crates/gui/src/app.rs`)
- App shell → Programs page: shows (evidence: `crates/gui/src/app.rs`)
- App shell → Startup page: shows (evidence: `crates/gui/src/app.rs`)
- App shell → Debloat page: shows (evidence: `crates/gui/src/app.rs`)
- App shell → Repair page: shows (evidence: `crates/gui/src/app.rs`)
- App shell → Disk explorer: shows (evidence: `crates/gui/src/app.rs`)
- App shell → Duplicate finder: shows (evidence: `crates/gui/src/app.rs`)
- App shell → Settings page: shows (evidence: `crates/gui/src/app.rs`)
- Clean page → Scan and clean: requests scans
- Programs page → Program removal: manages programs
- Startup page → Startup entries: manages entries
- Debloat page → Store app removal: removes apps
- Repair page → Broken-item repair: repairs leftovers
- Disk explorer → Disk usage scan: scans drives
- Duplicate finder → Duplicate scan: finds copies
- Settings page → Persistent settings: configures
- App shell → Shared UI state: creates state (evidence: `crates/gui/src/app.rs`)
- Scan and clean → Target resolution: resolves targets (evidence: `crates/core/src/engine.rs`)
- Scan and clean → Cleaning targets: uses definitions (evidence: `crates/core/src/engine.rs`)
- Scan and clean → Filesystem walker: scans and purges (evidence: `crates/core/src/engine.rs`)
- Scan and clean → Safety guard: checks paths (evidence: `crates/core/src/engine.rs`)
- Scan and clean → Progress and cancel: updates progress (evidence: `crates/core/src/engine.rs`)
- Scan and clean → Deletion logs: records deletions (evidence: `crates/core/src/engine.rs`)
- Filesystem walker → Safety guard: checks deletion (evidence: `crates/core/src/fsops.rs`)
- Filesystem walker → Deletion logs: records results (evidence: `crates/core/src/fsops.rs`)
- Target resolution → Path resolution: expands paths (evidence: `crates/core/src/resolve.rs`)
- Program removal → Registry access: reads registry (evidence: `crates/core/src/uninstall.rs`)
- Program removal → Filesystem walker: removes files (evidence: `crates/core/src/uninstall.rs`)
- Startup entries → Registry access: accesses entries (evidence: `crates/core/src/startup.rs`)
- Broken-item repair → Startup entries: checks startup (evidence: `crates/core/src/broken.rs`)
- Broken-item repair → Program removal: checks leftovers (evidence: `crates/core/src/broken.rs`)
- Broken-item repair → Filesystem walker: removes files (evidence: `crates/core/src/broken.rs`)
- Store app removal → Windows API layer: uses system APIs (evidence: `crates/core/src/bloat.rs`)
- Special cleanups → Windows API layer: uses Windows tools (evidence: `crates/core/src/special.rs`)
- Special cleanups → Registry access: accesses registry (evidence: `crates/core/src/special.rs`)
- Disk usage scan → Path resolution: uses path helpers (evidence: `crates/core/src/diskusage.rs`)
- Duplicate scan → Path resolution: uses path helpers (evidence: `crates/core/src/duplicates.rs`)
