# gadgetcue/macdock architecture

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

- Interactive diagram: https://gitdiagram.com/gadgetcue/macdock
- Repository: https://github.com/gadgetcue/macdock

## Overview

MacDock is a Windows 11 desktop-shell replacement that presents a macOS-style dock, menu bar and Dynamic Island. Users launch and manage pinned apps and folders from the dock, then use overviews, previews, settings and system controls to interact with Windows. The graph separates the shell surfaces, window/app experiences, system integrations and shared configuration/icon services. Relationships are limited to source-index references and explicit README capabilities; unsampled implementation details are not inferred.

Main entry points: [`mac-dock/MacDock.cs`](https://github.com/gadgetcue/macdock/blob/main/mac-dock/MacDock.cs) (Dock), [`mac-dock/MissionControl.cs`](https://github.com/gadgetcue/macdock/blob/main/mac-dock/MissionControl.cs) (Mission Control), [`mac-dock/Settings.cs`](https://github.com/gadgetcue/macdock/blob/main/mac-dock/Settings.cs) (Settings app), [`mac-dock/TopBar.cs`](https://github.com/gadgetcue/macdock/blob/main/mac-dock/TopBar.cs) (Top menu bar)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["Desktop shell"]
  node_dock["Dock<br/>[MacDock.cs]"]
  node_topbar["Top menu bar<br/>[TopBar.cs]"]
  node_island["Dynamic Island<br/>[Island.cs]"]
  node_panels["Status panels<br/>[Panels.cs]"]
end

subgraph group_apps["App and window experiences"]
  node_mission["Mission Control<br/>[MissionControl.cs]"]
  node_preview["Window previews<br/>[WindowPreview.cs]"]
  node_spotlight["Spotlight search<br/>[Spotlight.cs]"]
  node_genie["Genie animation<br/>[Genie.cs]"]
  node_downloads["Folder fan<br/>[DownloadsFan.cs]"]
  node_pwa["Web apps<br/>[Pwa.cs]"]
end

subgraph group_system["System integrations"]
  node_settings["Settings app<br/>[Settings.cs]"]
  node_control["Control Center<br/>[ControlCenter.cs]"]
  node_notifications[("Notifications feed<br/>[Notifications.cs]")]
  node_systeminfo["System status<br/>[SystemInfo.cs]"]
  node_touchpad["Touchpad gestures<br/>[Touchpad.cs]"]
end

subgraph group_shared["Shared services"]
  node_paths[("User configuration<br/>[AppPaths.cs]")]
  node_icons["Icon packs<br/>[IconPack.cs]"]
  node_iconchoice["Icon selection<br/>[IconChoice.cs]"]
  node_shellicons["Windows app icons<br/>[ShellIcons.cs]"]
  node_win32["Windows API layer<br/>[Win32.cs]"]
end

subgraph group_sharing["Nearby sharing"]
  node_local["LocalSend<br/>[LocalSend.cs]"]
end

node_user(("User"))
node_peers(("Nearby devices"))
node_windows(("Windows desktop"))

node_user -->|"uses"| node_dock
node_dock -->|"starts"| node_topbar
node_dock -->|"starts"| node_island
node_dock -->|"opens"| node_mission
node_dock -->|"opens"| node_spotlight
node_dock -->|"uses"| node_genie
node_dock -->|"opens"| node_downloads
node_dock -->|"opens"| node_preview
node_dock -->|"opens"| node_settings
node_dock -->|"starts"| node_local
node_topbar -->|"opens"| node_panels
node_topbar -->|"reads"| node_systeminfo
node_topbar -->|"opens"| node_settings
node_island -->|"reads"| node_notifications
node_island -->|"reads"| node_systeminfo
node_island -->|"validates links"| node_pwa
node_settings -->|"reads and writes"| node_paths
node_settings -->|"configures"| node_touchpad
node_control -->|"reads settings"| node_settings
node_control -->|"controls"| node_windows
node_mission -->|"selects icons"| node_iconchoice
node_mission -->|"handles web apps"| node_pwa
node_iconchoice -->|"checks pack"| node_icons
node_icons -->|"reads files"| node_paths
node_iconchoice -->|"classifies apps"| node_mission
node_dock -->|"reads configuration"| node_paths
node_dock -->|"uses APIs"| node_win32
node_preview -->|"gets window titles"| node_win32
node_touchpad -->|"opens overview"| node_mission
node_local -->|"transfers files"| node_peers
node_shellicons -->|"gets app icons"| node_windows

click node_dock "https://github.com/gadgetcue/macdock/blob/main/mac-dock/MacDock.cs"
click node_topbar "https://github.com/gadgetcue/macdock/blob/main/mac-dock/TopBar.cs"
click node_island "https://github.com/gadgetcue/macdock/blob/main/mac-dock/Island.cs"
click node_panels "https://github.com/gadgetcue/macdock/blob/main/mac-dock/Panels.cs"
click node_mission "https://github.com/gadgetcue/macdock/blob/main/mac-dock/MissionControl.cs"
click node_preview "https://github.com/gadgetcue/macdock/blob/main/mac-dock/WindowPreview.cs"
click node_spotlight "https://github.com/gadgetcue/macdock/blob/main/mac-dock/Spotlight.cs"
click node_genie "https://github.com/gadgetcue/macdock/blob/main/mac-dock/Genie.cs"
click node_downloads "https://github.com/gadgetcue/macdock/blob/main/mac-dock/DownloadsFan.cs"
click node_pwa "https://github.com/gadgetcue/macdock/blob/main/mac-dock/Pwa.cs"
click node_settings "https://github.com/gadgetcue/macdock/blob/main/mac-dock/Settings.cs"
click node_control "https://github.com/gadgetcue/macdock/blob/main/mac-dock/ControlCenter.cs"
click node_notifications "https://github.com/gadgetcue/macdock/blob/main/mac-dock/Notifications.cs"
click node_systeminfo "https://github.com/gadgetcue/macdock/blob/main/mac-dock/SystemInfo.cs"
click node_touchpad "https://github.com/gadgetcue/macdock/blob/main/mac-dock/Touchpad.cs"
click node_local "https://github.com/gadgetcue/macdock/blob/main/mac-dock/LocalSend.cs"
click node_paths "https://github.com/gadgetcue/macdock/blob/main/mac-dock/AppPaths.cs"
click node_icons "https://github.com/gadgetcue/macdock/blob/main/mac-dock/IconPack.cs"
click node_iconchoice "https://github.com/gadgetcue/macdock/blob/main/mac-dock/IconChoice.cs"
click node_shellicons "https://github.com/gadgetcue/macdock/blob/main/mac-dock/ShellIcons.cs"
click node_win32 "https://github.com/gadgetcue/macdock/blob/main/mac-dock/Win32.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_dock,node_topbar,node_island,node_panels,node_user toneBlue
class node_mission,node_preview,node_spotlight,node_genie,node_downloads,node_pwa toneAmber
class node_settings,node_control,node_notifications,node_systeminfo,node_touchpad toneMint
class node_paths,node_icons,node_iconchoice,node_shellicons,node_win32 toneRose
class node_local,node_peers,node_windows toneIndigo
```

## Components

### Desktop shell

- [Dock](https://github.com/gadgetcue/macdock/blob/main/mac-dock/MacDock.cs): `mac-dock/MacDock.cs`
- [Top menu bar](https://github.com/gadgetcue/macdock/blob/main/mac-dock/TopBar.cs): `mac-dock/TopBar.cs`
- [Dynamic Island](https://github.com/gadgetcue/macdock/blob/main/mac-dock/Island.cs): `mac-dock/Island.cs`
- [Status panels](https://github.com/gadgetcue/macdock/blob/main/mac-dock/Panels.cs): `mac-dock/Panels.cs`

### App and window experiences

- [Mission Control](https://github.com/gadgetcue/macdock/blob/main/mac-dock/MissionControl.cs): `mac-dock/MissionControl.cs`
- [Window previews](https://github.com/gadgetcue/macdock/blob/main/mac-dock/WindowPreview.cs): `mac-dock/WindowPreview.cs`
- [Spotlight search](https://github.com/gadgetcue/macdock/blob/main/mac-dock/Spotlight.cs): `mac-dock/Spotlight.cs`
- [Genie animation](https://github.com/gadgetcue/macdock/blob/main/mac-dock/Genie.cs): `mac-dock/Genie.cs`
- [Folder fan](https://github.com/gadgetcue/macdock/blob/main/mac-dock/DownloadsFan.cs): `mac-dock/DownloadsFan.cs`
- [Web apps](https://github.com/gadgetcue/macdock/blob/main/mac-dock/Pwa.cs): `mac-dock/Pwa.cs`

### System integrations

- [Settings app](https://github.com/gadgetcue/macdock/blob/main/mac-dock/Settings.cs): `mac-dock/Settings.cs`
- [Control Center](https://github.com/gadgetcue/macdock/blob/main/mac-dock/ControlCenter.cs): `mac-dock/ControlCenter.cs`
- [Notifications feed](https://github.com/gadgetcue/macdock/blob/main/mac-dock/Notifications.cs): `mac-dock/Notifications.cs`
- [System status](https://github.com/gadgetcue/macdock/blob/main/mac-dock/SystemInfo.cs): `mac-dock/SystemInfo.cs`
- [Touchpad gestures](https://github.com/gadgetcue/macdock/blob/main/mac-dock/Touchpad.cs): `mac-dock/Touchpad.cs`

### Shared services

- [User configuration](https://github.com/gadgetcue/macdock/blob/main/mac-dock/AppPaths.cs): `mac-dock/AppPaths.cs`
- [Icon packs](https://github.com/gadgetcue/macdock/blob/main/mac-dock/IconPack.cs): `mac-dock/IconPack.cs`
- [Icon selection](https://github.com/gadgetcue/macdock/blob/main/mac-dock/IconChoice.cs): `mac-dock/IconChoice.cs`
- [Windows app icons](https://github.com/gadgetcue/macdock/blob/main/mac-dock/ShellIcons.cs): `mac-dock/ShellIcons.cs`
- [Windows API layer](https://github.com/gadgetcue/macdock/blob/main/mac-dock/Win32.cs): `mac-dock/Win32.cs`

### Nearby sharing

- [LocalSend](https://github.com/gadgetcue/macdock/blob/main/mac-dock/LocalSend.cs): `mac-dock/LocalSend.cs`

### Other components

- **User**
- **Nearby devices**
- **Windows desktop**

## Connections

- User → Dock: uses (evidence: `README.md`)
- Dock → Top menu bar: starts (evidence: `mac-dock/MacDock.cs`)
- Dock → Dynamic Island: starts (evidence: `mac-dock/MacDock.cs`)
- Dock → Mission Control: opens (evidence: `mac-dock/MacDock.cs`)
- Dock → Spotlight search: opens (evidence: `mac-dock/MacDock.cs`)
- Dock → Genie animation: uses (evidence: `mac-dock/MacDock.cs`)
- Dock → Folder fan: opens (evidence: `mac-dock/MacDock.cs`)
- Dock → Window previews: opens (evidence: `README.md`)
- Dock → Settings app: opens (evidence: `mac-dock/MacDock.cs`)
- Dock → LocalSend: starts (evidence: `mac-dock/MacDock.cs`)
- Top menu bar → Status panels: opens (evidence: `mac-dock/TopBar.cs`)
- Top menu bar → System status: reads (evidence: `mac-dock/TopBar.cs`)
- Top menu bar → Settings app: opens (evidence: `mac-dock/TopBar.cs`)
- Dynamic Island → Notifications feed: reads (evidence: `mac-dock/Island.cs`)
- Dynamic Island → System status: reads (evidence: `mac-dock/Island.cs`)
- Dynamic Island → Web apps: validates links (evidence: `mac-dock/Island.cs`)
- Settings app → User configuration: reads and writes (evidence: `mac-dock/Settings.cs`)
- Settings app → Touchpad gestures: configures (evidence: `mac-dock/Settings.cs`)
- Control Center → Settings app: reads settings (evidence: `mac-dock/ControlCenter.cs`)
- Control Center → Windows desktop: controls (evidence: `README.md`)
- Mission Control → Icon selection: selects icons (evidence: `mac-dock/MissionControl.cs`)
- Mission Control → Web apps: handles web apps (evidence: `mac-dock/MissionControl.cs`)
- Icon selection → Icon packs: checks pack (evidence: `mac-dock/IconChoice.cs`)
- Icon packs → User configuration: reads files (evidence: `mac-dock/IconPack.cs`)
- Icon selection → Mission Control: classifies apps (evidence: `mac-dock/IconChoice.cs`)
- Dock → User configuration: reads configuration (evidence: `mac-dock/MacDock.cs`)
- Dock → Windows API layer: uses APIs (evidence: `mac-dock/MacDock.cs`)
- Window previews → Windows API layer: gets window titles (evidence: `mac-dock/WindowPreview.cs`)
- Touchpad gestures → Mission Control: opens overview (evidence: `README.md`)
- LocalSend → Nearby devices: transfers files (evidence: `README.md`)
- Windows app icons → Windows desktop: gets app icons (evidence: `mac-dock/ShellIcons.cs`)
