# phalchanouksa/win11desktopgroups architecture

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

- Interactive diagram: https://gitdiagram.com/phalchanouksa/win11desktopgroups
- Repository: https://github.com/phalchanouksa/win11desktopgroups

## Overview

Win11 Desktop Groups is a Windows WPF desktop organizer: users create or open desktop folder tiles, add shortcuts and files, then launch items from an expanded folder. MainWindow coordinates persisted groups, tray actions, and desktop placement; folder controls and flyouts handle interaction, while settings and wallpaper effects customize presentation. The graph preserves the documented drag-and-drop, rename, move, launch, and tray capabilities. Some implementation details are unsampled, so edges rely on the shown excerpts, SOURCE INDEX references, or README statements.

Main entry points: [`MainWindow.xaml.cs`](https://github.com/phalchanouksa/win11desktopgroups/blob/main/MainWindow.xaml.cs) (Desktop coordinator), [`Services/ConfigService.cs`](https://github.com/phalchanouksa/win11desktopgroups/blob/main/Services/ConfigService.cs) (Config persistence), [`FolderWidgetWindow.xaml.cs`](https://github.com/phalchanouksa/win11desktopgroups/blob/main/FolderWidgetWindow.xaml.cs) (Expanded folder), [`Services/ShellInterop.cs`](https://github.com/phalchanouksa/win11desktopgroups/blob/main/Services/ShellInterop.cs) (Windows shell interop)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop_ui["Desktop UI"]
  node_main_window["Desktop coordinator<br/>[MainWindow.xaml.cs]"]
  node_desktop_tiles["Folder tiles"]
  node_settings_window["Settings UI"]
  node_tray["System tray<br/>[TrayIconService.cs]"]
end

subgraph group_folder_workflow["Folder Workflow"]
  node_folder_widget["Expanded folder"]
  node_flyout["Item flyout"]
end

subgraph group_state_settings["State &amp; Settings"]
  node_folder_model["Folder group model"]
  node_desktop_item["Shortcut item<br/>[DesktopItem.cs]"]
  node_settings_model["App settings<br/>[AppSettings.cs]"]
  node_config["Config persistence<br/>[ConfigService.cs]"]
end

subgraph group_windows_services["Windows Services"]
  node_autostart["Windows autostart"]
  node_arrangement["Desktop placement"]
  node_shell["Windows shell interop<br/>[ShellInterop.cs]"]
  node_wallpaper["Wallpaper effects"]
end

node_user(("Desktop user"))
node_windows_desktop["Windows desktop and shell"]

node_user -->|"uses"| node_main_window
node_main_window -->|"loads and saves"| node_config
node_main_window -->|"initializes"| node_tray
node_main_window -->|"queries placement"| node_arrangement
node_main_window -->|"reads settings"| node_settings_model
node_main_window -->|"uses shell APIs"| node_shell
node_main_window -->|"manages groups"| node_folder_model
node_user -->|"opens and moves"| node_desktop_tiles
node_desktop_tiles -->|"opens"| node_flyout
node_desktop_tiles -->|"saves groups"| node_config
node_desktop_tiles -->|"uses model"| node_folder_model
node_desktop_tiles -->|"adds dropped items"| node_desktop_item
node_user -->|"drops and launches items"| node_folder_widget
node_folder_widget -->|"loads item icons"| node_desktop_item
node_folder_widget -->|"gets icon metrics"| node_arrangement
node_folder_widget -->|"updates background"| node_wallpaper
node_folder_widget -->|"uses shell APIs"| node_shell
node_folder_widget -->|"saves groups"| node_config
node_folder_widget -->|"reads appearance"| node_settings_model
node_flyout -->|"uses items"| node_desktop_item
node_flyout -->|"uses persistence"| node_config
node_flyout -->|"uses shell APIs"| node_shell
node_user -->|"customizes"| node_settings_window
node_settings_window -->|"loads and saves"| node_config
node_settings_window -->|"uses wallpaper effects"| node_wallpaper
node_user -->|"opens tray menu"| node_tray
node_tray -->|"checks startup state"| node_autostart
node_tray -->|"registers tray actions"| node_shell
node_desktop_item -->|"loads and launches"| node_shell
node_config -->|"loads and saves groups"| node_folder_model
node_config -->|"loads and saves settings"| node_settings_model
node_config -->|"places defaults"| node_arrangement
node_arrangement -->|"uses shell APIs"| node_shell
node_shell -.->|"controls desktop shell"| node_windows_desktop
node_wallpaper -.->|"reads wallpaper"| node_windows_desktop
node_main_window -->|"initializes effects"| node_wallpaper

click node_main_window "https://github.com/phalchanouksa/win11desktopgroups/blob/main/MainWindow.xaml.cs"
click node_desktop_tiles "https://github.com/phalchanouksa/win11desktopgroups/blob/main/Controls/FolderGroupControl.xaml.cs"
click node_folder_widget "https://github.com/phalchanouksa/win11desktopgroups/blob/main/FolderWidgetWindow.xaml.cs"
click node_flyout "https://github.com/phalchanouksa/win11desktopgroups/blob/main/FlyoutWindow.xaml.cs"
click node_folder_model "https://github.com/phalchanouksa/win11desktopgroups/blob/main/Models/FolderGroupModel.cs"
click node_desktop_item "https://github.com/phalchanouksa/win11desktopgroups/blob/main/Models/DesktopItem.cs"
click node_settings_model "https://github.com/phalchanouksa/win11desktopgroups/blob/main/Models/AppSettings.cs"
click node_config "https://github.com/phalchanouksa/win11desktopgroups/blob/main/Services/ConfigService.cs"
click node_settings_window "https://github.com/phalchanouksa/win11desktopgroups/blob/main/SettingsWindow.xaml.cs"
click node_tray "https://github.com/phalchanouksa/win11desktopgroups/blob/main/Services/TrayIconService.cs"
click node_autostart "https://github.com/phalchanouksa/win11desktopgroups/blob/main/Services/AutoStartService.cs"
click node_arrangement "https://github.com/phalchanouksa/win11desktopgroups/blob/main/Services/DesktopArrangementService.cs"
click node_shell "https://github.com/phalchanouksa/win11desktopgroups/blob/main/Services/ShellInterop.cs"
click node_wallpaper "https://github.com/phalchanouksa/win11desktopgroups/blob/main/Services/WallpaperMicaService.cs"

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_main_window,node_desktop_tiles,node_settings_window,node_tray,node_user toneBlue
class node_folder_widget,node_flyout toneAmber
class node_folder_model,node_desktop_item,node_settings_model,node_config toneMint
class node_autostart,node_arrangement,node_shell,node_wallpaper toneRose
class node_windows_desktop toneIndigo
```

## Components

### Desktop UI

- [Desktop coordinator](https://github.com/phalchanouksa/win11desktopgroups/blob/main/MainWindow.xaml.cs): `MainWindow.xaml.cs`
- [Folder tiles](https://github.com/phalchanouksa/win11desktopgroups/blob/main/Controls/FolderGroupControl.xaml.cs): `Controls/FolderGroupControl.xaml.cs`
- [Settings UI](https://github.com/phalchanouksa/win11desktopgroups/blob/main/SettingsWindow.xaml.cs): `SettingsWindow.xaml.cs`
- [System tray](https://github.com/phalchanouksa/win11desktopgroups/blob/main/Services/TrayIconService.cs): `Services/TrayIconService.cs`

### Folder Workflow

- [Expanded folder](https://github.com/phalchanouksa/win11desktopgroups/blob/main/FolderWidgetWindow.xaml.cs): `FolderWidgetWindow.xaml.cs`
- [Item flyout](https://github.com/phalchanouksa/win11desktopgroups/blob/main/FlyoutWindow.xaml.cs): `FlyoutWindow.xaml.cs`

### State & Settings

- [Folder group model](https://github.com/phalchanouksa/win11desktopgroups/blob/main/Models/FolderGroupModel.cs): `Models/FolderGroupModel.cs`
- [Shortcut item](https://github.com/phalchanouksa/win11desktopgroups/blob/main/Models/DesktopItem.cs): `Models/DesktopItem.cs`
- [App settings](https://github.com/phalchanouksa/win11desktopgroups/blob/main/Models/AppSettings.cs): `Models/AppSettings.cs`
- [Config persistence](https://github.com/phalchanouksa/win11desktopgroups/blob/main/Services/ConfigService.cs): `Services/ConfigService.cs`

### Windows Services

- [Windows autostart](https://github.com/phalchanouksa/win11desktopgroups/blob/main/Services/AutoStartService.cs): `Services/AutoStartService.cs`
- [Desktop placement](https://github.com/phalchanouksa/win11desktopgroups/blob/main/Services/DesktopArrangementService.cs): `Services/DesktopArrangementService.cs`
- [Windows shell interop](https://github.com/phalchanouksa/win11desktopgroups/blob/main/Services/ShellInterop.cs): `Services/ShellInterop.cs`
- [Wallpaper effects](https://github.com/phalchanouksa/win11desktopgroups/blob/main/Services/WallpaperMicaService.cs): `Services/WallpaperMicaService.cs`

### Other components

- **Desktop user**
- **Windows desktop and shell**

## Connections

- Desktop user → Desktop coordinator: uses (evidence: `README.md`)
- Desktop coordinator → Config persistence: loads and saves (evidence: `MainWindow.xaml.cs`)
- Desktop coordinator → System tray: initializes (evidence: `MainWindow.xaml.cs`)
- Desktop coordinator → Desktop placement: queries placement (evidence: `MainWindow.xaml.cs`)
- Desktop coordinator → App settings: reads settings (evidence: `MainWindow.xaml.cs`)
- Desktop coordinator → Windows shell interop: uses shell APIs (evidence: `MainWindow.xaml.cs`)
- Desktop coordinator → Folder group model: manages groups (evidence: `MainWindow.xaml.cs`)
- Desktop user → Folder tiles: opens and moves (evidence: `README.md`)
- Folder tiles → Item flyout: opens (evidence: `Controls/FolderGroupControl.xaml.cs`)
- Folder tiles → Config persistence: saves groups (evidence: `Controls/FolderGroupControl.xaml.cs`)
- Folder tiles → Folder group model: uses model (evidence: `Controls/FolderGroupControl.xaml.cs`)
- Folder tiles → Shortcut item: adds dropped items (evidence: `Controls/FolderGroupControl.xaml.cs`)
- Desktop user → Expanded folder: drops and launches items (evidence: `README.md`)
- Expanded folder → Shortcut item: loads item icons (evidence: `FolderWidgetWindow.xaml.cs`)
- Expanded folder → Desktop placement: gets icon metrics (evidence: `FolderWidgetWindow.xaml.cs`)
- Expanded folder → Wallpaper effects: updates background (evidence: `FolderWidgetWindow.xaml.cs`)
- Expanded folder → Windows shell interop: uses shell APIs (evidence: `FolderWidgetWindow.xaml.cs`)
- Expanded folder → Config persistence: saves groups (evidence: `FolderWidgetWindow.xaml.cs`)
- Expanded folder → App settings: reads appearance (evidence: `FolderWidgetWindow.xaml.cs`)
- Item flyout → Shortcut item: uses items (evidence: `FlyoutWindow.xaml.cs`)
- Item flyout → Config persistence: uses persistence (evidence: `FlyoutWindow.xaml.cs`)
- Item flyout → Windows shell interop: uses shell APIs (evidence: `FlyoutWindow.xaml.cs`)
- Desktop user → Settings UI: customizes (evidence: `README.md`)
- Settings UI → Config persistence: loads and saves (evidence: `SettingsWindow.xaml.cs`)
- Settings UI → Wallpaper effects: uses wallpaper effects (evidence: `SettingsWindow.xaml.cs`)
- Desktop user → System tray: opens tray menu (evidence: `README.md`)
- System tray → Windows autostart: checks startup state (evidence: `Services/TrayIconService.cs`)
- System tray → Windows shell interop: registers tray actions (evidence: `Services/TrayIconService.cs`)
- Shortcut item → Windows shell interop: loads and launches (evidence: `Models/DesktopItem.cs`)
- Config persistence → Folder group model: loads and saves groups (evidence: `Services/ConfigService.cs`)
- Config persistence → App settings: loads and saves settings (evidence: `Services/ConfigService.cs`)
- Config persistence → Desktop placement: places defaults (evidence: `Services/ConfigService.cs`)
- Desktop placement → Windows shell interop: uses shell APIs (evidence: `Services/DesktopArrangementService.cs`)
- Windows shell interop → Windows desktop and shell: controls desktop shell
- Wallpaper effects → Windows desktop and shell: reads wallpaper
- Desktop coordinator → Wallpaper effects: initializes effects
