# christitustech/winutil architecture

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

- Interactive diagram: https://gitdiagram.com/christitustech/winutil
- Repository: https://github.com/christitustech/winutil

## Overview

WinUtil is an administrator-run PowerShell utility for configuring Windows: users launch it, choose system tasks or apply a preset, and the utility makes system-wide changes. The README documents installs, debloating tweaks, troubleshooting/configuration, and Windows Update controls; the tree shows corresponding PowerShell entry points and JSON configuration. Source excerpts cover only a separate title-screen image-generation tool, so runtime call relationships among WinUtil’s components are not verified here; links to those components are therefore marked unverified.

Main entry points: [`functions/public/Initialize-WPFUI.ps1`](https://github.com/christitustech/winutil/blob/main/functions/public/Initialize-WPFUI.ps1) (WPF interface), [`scripts/start.ps1`](https://github.com/christitustech/winutil/blob/main/scripts/start.ps1) (PowerShell launch), [`scripts/main.ps1`](https://github.com/christitustech/winutil/blob/main/scripts/main.ps1) (WinUtil runtime), [`functions/public/Invoke-WPFInstall.ps1`](https://github.com/christitustech/winutil/blob/main/functions/public/Invoke-WPFInstall.ps1) (App installs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Launch and UI"]
  node_launcher["PowerShell launch<br/>[start.ps1]"]
  node_runtime["WinUtil runtime<br/>[main.ps1]"]
  node_wpf["WPF interface"]
end

subgraph group_install["App installation"]
  node_appinstall["App installs"]
end

subgraph group_system["System configuration"]
  node_tweaks["Windows tweaks"]
  node_features["Windows features"]
  node_fixes["System fixes"]
  node_updates["Update controls"]
  node_presets["Preset automation"]
end

subgraph group_data["Configuration data"]
  node_appdata["App catalog<br/>[applications.json]"]
  node_tweakdata["Tweak definitions<br/>[tweaks.json]"]
  node_featuredata["Feature definitions<br/>[feature.json]"]
  node_presetdata["Preset definitions<br/>[preset.json]"]
  node_dnsdata["DNS settings<br/>[dns.json]"]
  node_appxdata["AppX settings<br/>[appx.json]"]
end

node_admin(("Administrator"))

node_admin -->|"runs as"| node_launcher
node_launcher -.->|"starts"| node_runtime
node_runtime -.->|"opens interface"| node_wpf
node_wpf -.->|"offers installs"| node_appinstall
node_wpf -.->|"offers tweaks"| node_tweaks
node_wpf -.->|"offers features"| node_features
node_wpf -.->|"offers repair"| node_fixes
node_wpf -.->|"offers controls"| node_updates
node_wpf -.->|"offers presets"| node_presets
node_presets -.->|"applies preset"| node_presetdata
node_appinstall -.->|"uses catalog"| node_appdata
node_tweaks -.->|"uses definitions"| node_tweakdata
node_features -.->|"uses definitions"| node_featuredata

click node_launcher "https://github.com/christitustech/winutil/blob/main/scripts/start.ps1"
click node_runtime "https://github.com/christitustech/winutil/blob/main/scripts/main.ps1"
click node_wpf "https://github.com/christitustech/winutil/blob/main/functions/public/Initialize-WPFUI.ps1"
click node_appinstall "https://github.com/christitustech/winutil/blob/main/functions/public/Invoke-WPFInstall.ps1"
click node_appdata "https://github.com/christitustech/winutil/blob/main/config/applications.json"
click node_tweaks "https://github.com/christitustech/winutil/blob/main/functions/public/Invoke-WPFtweaksbutton.ps1"
click node_tweakdata "https://github.com/christitustech/winutil/blob/main/config/tweaks.json"
click node_features "https://github.com/christitustech/winutil/blob/main/functions/public/Invoke-WPFFeatureInstall.ps1"
click node_featuredata "https://github.com/christitustech/winutil/blob/main/config/feature.json"
click node_fixes "https://github.com/christitustech/winutil/blob/main/functions/public/Invoke-WPFSystemRepair.ps1"
click node_updates "https://github.com/christitustech/winutil/blob/main/functions/public/Invoke-WPFUpdatesdefault.ps1"
click node_presets "https://github.com/christitustech/winutil/blob/main/functions/public/Invoke-WPFPresets.ps1"
click node_presetdata "https://github.com/christitustech/winutil/blob/main/config/preset.json"
click node_dnsdata "https://github.com/christitustech/winutil/blob/main/config/dns.json"
click node_appxdata "https://github.com/christitustech/winutil/blob/main/config/appx.json"

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_launcher,node_runtime,node_wpf toneBlue
class node_appinstall toneAmber
class node_tweaks,node_features,node_fixes,node_updates,node_presets toneMint
class node_appdata,node_tweakdata,node_featuredata,node_presetdata,node_dnsdata,node_appxdata toneRose
class node_admin toneIndigo
```

## Components

### Launch and UI

- [PowerShell launch](https://github.com/christitustech/winutil/blob/main/scripts/start.ps1): `scripts/start.ps1`
- [WinUtil runtime](https://github.com/christitustech/winutil/blob/main/scripts/main.ps1): `scripts/main.ps1`
- [WPF interface](https://github.com/christitustech/winutil/blob/main/functions/public/Initialize-WPFUI.ps1): `functions/public/Initialize-WPFUI.ps1`

### App installation

- [App installs](https://github.com/christitustech/winutil/blob/main/functions/public/Invoke-WPFInstall.ps1): `functions/public/Invoke-WPFInstall.ps1`

### System configuration

- [Windows tweaks](https://github.com/christitustech/winutil/blob/main/functions/public/Invoke-WPFtweaksbutton.ps1): `functions/public/Invoke-WPFtweaksbutton.ps1`
- [Windows features](https://github.com/christitustech/winutil/blob/main/functions/public/Invoke-WPFFeatureInstall.ps1): `functions/public/Invoke-WPFFeatureInstall.ps1`
- [System fixes](https://github.com/christitustech/winutil/blob/main/functions/public/Invoke-WPFSystemRepair.ps1): `functions/public/Invoke-WPFSystemRepair.ps1`
- [Update controls](https://github.com/christitustech/winutil/blob/main/functions/public/Invoke-WPFUpdatesdefault.ps1): `functions/public/Invoke-WPFUpdatesdefault.ps1`
- [Preset automation](https://github.com/christitustech/winutil/blob/main/functions/public/Invoke-WPFPresets.ps1): `functions/public/Invoke-WPFPresets.ps1`

### Configuration data

- [App catalog](https://github.com/christitustech/winutil/blob/main/config/applications.json): `config/applications.json`
- [Tweak definitions](https://github.com/christitustech/winutil/blob/main/config/tweaks.json): `config/tweaks.json`
- [Feature definitions](https://github.com/christitustech/winutil/blob/main/config/feature.json): `config/feature.json`
- [Preset definitions](https://github.com/christitustech/winutil/blob/main/config/preset.json): `config/preset.json`
- [DNS settings](https://github.com/christitustech/winutil/blob/main/config/dns.json): `config/dns.json`
- [AppX settings](https://github.com/christitustech/winutil/blob/main/config/appx.json): `config/appx.json`

### Other components

- **Administrator**

## Connections

- Administrator → PowerShell launch: runs as (evidence: `README.md`)
- PowerShell launch → WinUtil runtime: starts
- WinUtil runtime → WPF interface: opens interface
- WPF interface → App installs: offers installs
- WPF interface → Windows tweaks: offers tweaks
- WPF interface → Windows features: offers features
- WPF interface → System fixes: offers repair
- WPF interface → Update controls: offers controls
- WPF interface → Preset automation: offers presets
- Preset automation → Preset definitions: applies preset
- App installs → App catalog: uses catalog
- Windows tweaks → Tweak definitions: uses definitions
- Windows features → Feature definitions: uses definitions
