How heyyczer/windows-dynamic-island works
Dynamic Island for Windows is a Tauri desktop overlay for modules such as music, AI-agent activity, screen search, and notifications. The principal flow is application startup → island controller → module content, with native providers supplying live state through the bridge; users can also open settings or a music picture-in-picture window. The graph preserves the README’s major capabilities and plugin/customization branch. Several feature implementations were not sampled, so their internal calls are not inferred; documented workflows and visible startup wiring support the relationships shown.
Main entry points: index.ts Module registry · Island.tsx Island surface · main.tsx Window bootstrap · bridge.ts Frontend bridge
Components 21
Desktop shell
- Window bootstrap
src/main.tsx - Island surface
src/components/Island.tsx - Island controller
src/core/useIslandController.ts - Frontend bridge
src/core/bridge.ts
Island modules
- Module registry
src/modules/index.ts - AI agents
src/modules/ai-agents - Ask Claude
src/modules/ask - Screen search
src/modules/find - Music controls
src/modules/music - Clock calendar
src/modules/clock - Clipboard history
src/modules/clipboard - File shelf
src/modules/shelf - Other modules
src/modules
Native services
- Native providers
src-tauri/src/providers - Plugin backend
src-tauri/src/plugins - Tauri application
src-tauri/src/lib.rs
Settings and plugins
- Settings store
src/core/settings.ts - Settings window
src/settings/SettingsApp.tsx - Plugin system
src/core/plugins/host.ts
Media windows
- Music PiP window
src/pip/PipApp.tsx
Other components
- Desktop user
Connections 22
- Desktop user → Window bootstrap: opens app
README.md - Window bootstrap → Island surface: loads island
src/main.tsx - Window bootstrap → Settings window: loads settings
src/main.tsx - Island surface → Island controller: gets state
src/components/Island.tsx - Island controller → Module registry: selects modules
src/core/useIslandController.ts - Module registry → AI agents: offers module
README.md - Module registry → Ask Claude: offers module
README.md - Module registry → Screen search: offers module
README.md - Module registry → Music controls: offers module
README.md - Module registry → Clock calendar: offers module
README.md - Module registry → Clipboard history: offers module
README.md - Module registry → File shelf: offers module
README.md - Module registry → Other modules: offers modules
README.md - Island surface → Frontend bridge: uses events
src/components/Island.tsx - Frontend bridge → Native providers: exchanges provider state
src/core/bridge.ts - Tauri application → Native providers: starts providers
src-tauri/src/lib.rs - Settings window → Settings store: reads settings
src/settings/SettingsApp.tsx - Settings store → Frontend bridge: persists settings
src/core/settings.ts - Island surface → Plugin system: hosts plugins
src/components/Island.tsx - Plugin system → Plugin backend: uses plugin backend
- Music controls → Music PiP window: opens pinned video
README.md - Desktop user → Settings window: customizes appearance
README.md