# sharancreatedthis/hangly-windows architecture

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

- Interactive diagram: https://gitdiagram.com/sharancreatedthis/hangly-windows
- Repository: https://github.com/sharancreatedthis/hangly-windows

## Overview

Hangly is a Windows desktop app that displays interactive charms hanging from a simulated rope. The main workflow is to open the Library, choose and arrange charms, then interact with them on the desktop; users can also import artwork or create a charm in Creator Studio. The README documents the major capabilities and broad layer boundaries. Several source files are indexed but not excerpted, so edges for those subsystems rely on README statements rather than inspected call sites; the Swift files are reference implementations.

Main entry points: [`src/Hangly.App/AppEnvironment.cs`](https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.App/AppEnvironment.cs) (App environment), [`src/Hangly.App/Overlay/OverlayWindow.cs`](https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.App/Overlay/OverlayWindow.cs) (Desktop overlay), [`src/Hangly.App/Customize/CustomizeWindow.xaml.cs`](https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.App/Customize/CustomizeWindow.xaml.cs) (Library and settings UI), [`src/Hangly.Core/Physics/RopeSimulation.cs`](https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.Core/Physics/RopeSimulation.cs) (Rope simulation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Windows app"]
  node_startup["App startup<br/>[App.xaml.cs]"]
  node_environment["App environment<br/>[AppEnvironment.cs]"]
  node_customize["Library and settings UI"]
  node_overlay["Desktop overlay<br/>[OverlayWindow.cs]"]
  node_renderer["Rope renderer<br/>[RopeRenderer.cs]"]
  node_artcache["Artwork cache"]
end

subgraph group_core["Core models and runtime"]
  node_physics["Rope simulation<br/>[RopeSimulation.cs]"]
  node_layout["Charm stack layout"]
  node_ropeconfig["Rope configuration"]
  node_settings["Settings document<br/>[AppSettings.cs]"]
  node_settingsstore["Settings store<br/>[SettingsStore.cs]"]
end

subgraph group_creation["Charm library and creation"]
  node_catalog["Charm catalogue<br/>[CharmCatalog.cs]"]
  node_index["Charm index<br/>[CharmIndex.cs]"]
  node_search["Library search<br/>[CharmSearch.cs]"]
  node_importer["Artwork import<br/>[CharmImporter.cs]"]
  node_customstore[("Custom charm store")]
  node_studiosession["Studio session<br/>[StudioSession.cs]"]
  node_studiopipeline["Studio processing<br/>[StudioPipeline.cs]"]
  node_studioimage["Studio image model<br/>[StudioImage.cs]"]
  node_preview["Studio preview<br/>[StudioPreview.cs]"]
end

subgraph group_support["App services"]
  node_audio["Sound playback<br/>[AudioService.cs]"]
  node_notifications["Announcements"]
  node_updater["Self updater<br/>[Updater.cs]"]
  node_registry[("Installation registry")]
  node_analytics["Usage analytics<br/>[Ga4Session.cs]"]
end

subgraph group_reference["Swift reference"]
  node_swiftcharm["Charm reference model<br/>[Charm.swift]"]
  node_swiftlayout["Stack layout reference"]
  node_swiftconfig["Rope config reference"]
end

node_user(("User"))

node_user -->|"opens app"| node_startup
node_startup -->|"initializes"| node_environment
node_user -->|"chooses charms"| node_customize
node_customize -->|"filters library"| node_search
node_search -->|"searches"| node_index
node_index -->|"indexes"| node_catalog
node_customize -->|"saves preferences"| node_settingsstore
node_settingsstore -->|"reads and writes"| node_settings
node_environment -->|"creates overlay"| node_overlay
node_overlay -->|"advances simulation"| node_physics
node_physics -->|"positions charms"| node_layout
node_physics -->|"uses parameters"| node_ropeconfig
node_overlay -->|"draws frames"| node_renderer
node_renderer -->|"draws artwork"| node_artcache
node_user -->|"pushes charms"| node_overlay
node_user -->|"drops artwork"| node_importer
node_importer -->|"stores charm"| node_customstore
node_user -->|"creates charm"| node_studiosession
node_studiosession -->|"processes image"| node_studiopipeline
node_studiopipeline -->|"transforms image"| node_studioimage
node_studiosession -.->|"updates preview"| node_preview
node_preview -->|"renders preview"| node_renderer
node_preview -->|"loads draft art"| node_artcache
node_user -->|"hears charm sound"| node_audio
node_environment -.->|"shows announcements"| node_notifications
node_environment -->|"checks updates"| node_updater
node_updater -.->|"syncs installation"| node_registry
node_environment -.->|"reports usage"| node_analytics
node_swiftlayout -->|"arranges charms"| node_swiftcharm
node_swiftconfig -.->|"configures layout"| node_swiftlayout

click node_startup "https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.App/App.xaml.cs"
click node_environment "https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.App/AppEnvironment.cs"
click node_customize "https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.App/Customize/CustomizeWindow.xaml.cs"
click node_overlay "https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.App/Overlay/OverlayWindow.cs"
click node_renderer "https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.App/Overlay/RopeRenderer.cs"
click node_physics "https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.Core/Physics/RopeSimulation.cs"
click node_layout "https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.Core/Physics/CharmStackLayout.cs"
click node_ropeconfig "https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.Core/Physics/RopeConfiguration.cs"
click node_settings "https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.Core/Settings/AppSettings.cs"
click node_settingsstore "https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.Core/Settings/SettingsStore.cs"
click node_catalog "https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.Core/Models/CharmCatalog.cs"
click node_index "https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.Core/Models/CharmIndex.cs"
click node_search "https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.Core/Models/CharmSearch.cs"
click node_importer "https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.App/Import/CharmImporter.cs"
click node_customstore "https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.Core/Import/CustomCharmStore.cs"
click node_studiosession "https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.App/Studio/StudioSession.cs"
click node_studiopipeline "https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.Core/Studio/StudioPipeline.cs"
click node_studioimage "https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.Core/Studio/StudioImage.cs"
click node_preview "https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.App/Studio/StudioPreview.cs"
click node_artcache "https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.App/Overlay/CharmArtworkCache.cs"
click node_audio "https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.App/Audio/AudioService.cs"
click node_notifications "https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.App/Notifications/AnnouncementFeed.cs"
click node_updater "https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.App/Services/Updater.cs"
click node_registry "https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.Core/Registry/InstallationStore.cs"
click node_analytics "https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.Core/Analytics/Ga4Session.cs"
click node_swiftcharm "https://github.com/sharancreatedthis/hangly-windows/blob/main/reference/swift/Models/Charm.swift"
click node_swiftlayout "https://github.com/sharancreatedthis/hangly-windows/blob/main/reference/swift/Physics/CharmStackLayout.swift"
click node_swiftconfig "https://github.com/sharancreatedthis/hangly-windows/blob/main/reference/swift/Physics/RopeConfiguration.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_startup,node_environment,node_customize,node_overlay,node_renderer,node_artcache,node_user toneBlue
class node_physics,node_layout,node_ropeconfig,node_settings,node_settingsstore toneAmber
class node_catalog,node_index,node_search,node_importer,node_customstore,node_studiosession,node_studiopipeline,node_studioimage,node_preview toneMint
class node_audio,node_notifications,node_updater,node_registry,node_analytics toneRose
class node_swiftcharm,node_swiftlayout,node_swiftconfig toneIndigo
```

## Components

### Windows app

- [App startup](https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.App/App.xaml.cs): `src/Hangly.App/App.xaml.cs`
- [App environment](https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.App/AppEnvironment.cs): `src/Hangly.App/AppEnvironment.cs`
- [Library and settings UI](https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.App/Customize/CustomizeWindow.xaml.cs): `src/Hangly.App/Customize/CustomizeWindow.xaml.cs`
- [Desktop overlay](https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.App/Overlay/OverlayWindow.cs): `src/Hangly.App/Overlay/OverlayWindow.cs`
- [Rope renderer](https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.App/Overlay/RopeRenderer.cs): `src/Hangly.App/Overlay/RopeRenderer.cs`
- [Artwork cache](https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.App/Overlay/CharmArtworkCache.cs): `src/Hangly.App/Overlay/CharmArtworkCache.cs`

### Core models and runtime

- [Rope simulation](https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.Core/Physics/RopeSimulation.cs): `src/Hangly.Core/Physics/RopeSimulation.cs`
- [Charm stack layout](https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.Core/Physics/CharmStackLayout.cs): `src/Hangly.Core/Physics/CharmStackLayout.cs`
- [Rope configuration](https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.Core/Physics/RopeConfiguration.cs): `src/Hangly.Core/Physics/RopeConfiguration.cs`
- [Settings document](https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.Core/Settings/AppSettings.cs): `src/Hangly.Core/Settings/AppSettings.cs`
- [Settings store](https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.Core/Settings/SettingsStore.cs): `src/Hangly.Core/Settings/SettingsStore.cs`

### Charm library and creation

- [Charm catalogue](https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.Core/Models/CharmCatalog.cs): `src/Hangly.Core/Models/CharmCatalog.cs`
- [Charm index](https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.Core/Models/CharmIndex.cs): `src/Hangly.Core/Models/CharmIndex.cs`
- [Library search](https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.Core/Models/CharmSearch.cs): `src/Hangly.Core/Models/CharmSearch.cs`
- [Artwork import](https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.App/Import/CharmImporter.cs): `src/Hangly.App/Import/CharmImporter.cs`
- [Custom charm store](https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.Core/Import/CustomCharmStore.cs): `src/Hangly.Core/Import/CustomCharmStore.cs`
- [Studio session](https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.App/Studio/StudioSession.cs): `src/Hangly.App/Studio/StudioSession.cs`
- [Studio processing](https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.Core/Studio/StudioPipeline.cs): `src/Hangly.Core/Studio/StudioPipeline.cs`
- [Studio image model](https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.Core/Studio/StudioImage.cs): `src/Hangly.Core/Studio/StudioImage.cs`
- [Studio preview](https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.App/Studio/StudioPreview.cs): `src/Hangly.App/Studio/StudioPreview.cs`

### App services

- [Sound playback](https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.App/Audio/AudioService.cs): `src/Hangly.App/Audio/AudioService.cs`
- [Announcements](https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.App/Notifications/AnnouncementFeed.cs): `src/Hangly.App/Notifications/AnnouncementFeed.cs`
- [Self updater](https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.App/Services/Updater.cs): `src/Hangly.App/Services/Updater.cs`
- [Installation registry](https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.Core/Registry/InstallationStore.cs): `src/Hangly.Core/Registry/InstallationStore.cs`
- [Usage analytics](https://github.com/sharancreatedthis/hangly-windows/blob/main/src/Hangly.Core/Analytics/Ga4Session.cs): `src/Hangly.Core/Analytics/Ga4Session.cs`

### Swift reference

- [Charm reference model](https://github.com/sharancreatedthis/hangly-windows/blob/main/reference/swift/Models/Charm.swift): `reference/swift/Models/Charm.swift`
- [Stack layout reference](https://github.com/sharancreatedthis/hangly-windows/blob/main/reference/swift/Physics/CharmStackLayout.swift): `reference/swift/Physics/CharmStackLayout.swift`
- [Rope config reference](https://github.com/sharancreatedthis/hangly-windows/blob/main/reference/swift/Physics/RopeConfiguration.swift): `reference/swift/Physics/RopeConfiguration.swift`

### Other components

- **User**

## Connections

- User → App startup: opens app (evidence: `README.md`)
- App startup → App environment: initializes (evidence: `src/Hangly.App/App.xaml.cs`)
- User → Library and settings UI: chooses charms (evidence: `README.md`)
- Library and settings UI → Library search: filters library (evidence: `src/Hangly.App/Customize/CustomizeWindow.xaml.cs`)
- Library search → Charm index: searches (evidence: `src/Hangly.Core/Models/CharmSearch.cs`)
- Charm index → Charm catalogue: indexes (evidence: `src/Hangly.Core/Models/CharmIndex.cs`)
- Library and settings UI → Settings store: saves preferences (evidence: `src/Hangly.App/Customize/CustomizeWindow.xaml.cs`)
- Settings store → Settings document: reads and writes (evidence: `README.md`)
- App environment → Desktop overlay: creates overlay (evidence: `README.md`)
- Desktop overlay → Rope simulation: advances simulation (evidence: `README.md`)
- Rope simulation → Charm stack layout: positions charms (evidence: `src/Hangly.Core/Physics/RopeSimulation.Drag.cs`)
- Rope simulation → Rope configuration: uses parameters (evidence: `src/Hangly.Core/Physics/RopeSimulation.Drag.cs`)
- Desktop overlay → Rope renderer: draws frames (evidence: `README.md`)
- Rope renderer → Artwork cache: draws artwork (evidence: `src/Hangly.App/Overlay/RopeRenderer.cs`)
- User → Desktop overlay: pushes charms (evidence: `README.md`)
- User → Artwork import: drops artwork (evidence: `README.md`)
- Artwork import → Custom charm store: stores charm (evidence: `src/Hangly.App/Services/Diagnostics.cs`)
- User → Studio session: creates charm (evidence: `README.md`)
- Studio session → Studio processing: processes image (evidence: `src/Hangly.App/Studio/StudioSession.cs`)
- Studio processing → Studio image model: transforms image (evidence: `src/Hangly.Core/Studio/StudioPipeline.cs`)
- Studio session → Studio preview: updates preview
- Studio preview → Rope renderer: renders preview (evidence: `src/Hangly.App/Studio/StudioPreview.cs`)
- Studio preview → Artwork cache: loads draft art (evidence: `src/Hangly.App/Studio/StudioPreview.cs`)
- User → Sound playback: hears charm sound (evidence: `README.md`)
- App environment → Announcements: shows announcements
- App environment → Self updater: checks updates (evidence: `README.md`)
- Self updater → Installation registry: syncs installation
- App environment → Usage analytics: reports usage
- Stack layout reference → Charm reference model: arranges charms
- Rope config reference → Stack layout reference: configures layout (evidence: `reference/swift/Physics/CharmStackLayout.swift`)
