How sharancreatedthis/hangly-windows works
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: AppEnvironment.cs App environment · OverlayWindow.cs Desktop overlay · CustomizeWindow.xaml.cs Library and settings UI · RopeSimulation.cs Rope simulation
Components 29
Windows app
- App startup
src/Hangly.App/App.xaml.cs - App environment
src/Hangly.App/AppEnvironment.cs - Library and settings UI
src/Hangly.App/Customize/CustomizeWindow.xaml.cs - Desktop overlay
src/Hangly.App/Overlay/OverlayWindow.cs - Rope renderer
src/Hangly.App/Overlay/RopeRenderer.cs - Artwork cache
src/Hangly.App/Overlay/CharmArtworkCache.cs
Core models and runtime
- Rope simulation
src/Hangly.Core/Physics/RopeSimulation.cs - Charm stack layout
src/Hangly.Core/Physics/CharmStackLayout.cs - Rope configuration
src/Hangly.Core/Physics/RopeConfiguration.cs - Settings document
src/Hangly.Core/Settings/AppSettings.cs - Settings store
src/Hangly.Core/Settings/SettingsStore.cs
Charm library and creation
- Charm catalogue
src/Hangly.Core/Models/CharmCatalog.cs - Charm index
src/Hangly.Core/Models/CharmIndex.cs - Library search
src/Hangly.Core/Models/CharmSearch.cs - Artwork import
src/Hangly.App/Import/CharmImporter.cs - Custom charm store
src/Hangly.Core/Import/CustomCharmStore.cs - Studio session
src/Hangly.App/Studio/StudioSession.cs - Studio processing
src/Hangly.Core/Studio/StudioPipeline.cs - Studio image model
src/Hangly.Core/Studio/StudioImage.cs - Studio preview
src/Hangly.App/Studio/StudioPreview.cs
App services
- Sound playback
src/Hangly.App/Audio/AudioService.cs - Announcements
src/Hangly.App/Notifications/AnnouncementFeed.cs - Self updater
src/Hangly.App/Services/Updater.cs - Installation registry
src/Hangly.Core/Registry/InstallationStore.cs - Usage analytics
src/Hangly.Core/Analytics/Ga4Session.cs
Swift reference
- Charm reference model
reference/swift/Models/Charm.swift - Stack layout reference
reference/swift/Physics/CharmStackLayout.swift - Rope config reference
reference/swift/Physics/RopeConfiguration.swift
Other components
- User
Connections 30
- User → App startup: opens app
README.md - App startup → App environment: initializes
src/Hangly.App/App.xaml.cs - User → Library and settings UI: chooses charms
README.md - Library and settings UI → Library search: filters library
src/Hangly.App/Customize/CustomizeWindow.xaml.cs - Library search → Charm index: searches
src/Hangly.Core/Models/CharmSearch.cs - Charm index → Charm catalogue: indexes
src/Hangly.Core/Models/CharmIndex.cs - Library and settings UI → Settings store: saves preferences
src/Hangly.App/Customize/CustomizeWindow.xaml.cs - Settings store → Settings document: reads and writes
README.md - App environment → Desktop overlay: creates overlay
README.md - Desktop overlay → Rope simulation: advances simulation
README.md - Rope simulation → Charm stack layout: positions charms
src/Hangly.Core/Physics/RopeSimulation.Drag.cs - Rope simulation → Rope configuration: uses parameters
src/Hangly.Core/Physics/RopeSimulation.Drag.cs - Desktop overlay → Rope renderer: draws frames
README.md - Rope renderer → Artwork cache: draws artwork
src/Hangly.App/Overlay/RopeRenderer.cs - User → Desktop overlay: pushes charms
README.md - User → Artwork import: drops artwork
README.md - Artwork import → Custom charm store: stores charm
src/Hangly.App/Services/Diagnostics.cs - User → Studio session: creates charm
README.md - Studio session → Studio processing: processes image
src/Hangly.App/Studio/StudioSession.cs - Studio processing → Studio image model: transforms image
src/Hangly.Core/Studio/StudioPipeline.cs - Studio session → Studio preview: updates preview
- Studio preview → Rope renderer: renders preview
src/Hangly.App/Studio/StudioPreview.cs - Studio preview → Artwork cache: loads draft art
src/Hangly.App/Studio/StudioPreview.cs - User → Sound playback: hears charm sound
README.md - App environment → Announcements: shows announcements
- App environment → Self updater: checks updates
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
reference/swift/Physics/CharmStackLayout.swift