# kailash2006/dynamic-island-desktop architecture

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

- Interactive diagram: https://gitdiagram.com/kailash2006/dynamic-island-desktop
- Repository: https://github.com/kailash2006/dynamic-island-desktop

## Overview

Dynoland is a Windows desktop dynamic-island overlay. Users open the island or its control panel, choose or interact with an activity, and see live system events rendered in the island; the activity manager handles focus, switching and expiry. Windows media, notification, battery and backdrop capabilities feed that experience, while settings and Electron’s preload bridge connect the React renderer to desktop functions. The README documents several capabilities whose implementation details are not shown here, so those subsystem links are documented rather than inferred from unsampled code.

Main entry points: [`electron/main.cjs`](https://github.com/kailash2006/dynamic-island-desktop/blob/main/electron/main.cjs) (Electron host), [`src/components/DynamicIsland/DynamicIsland.jsx`](https://github.com/kailash2006/dynamic-island-desktop/blob/main/src/components/DynamicIsland/DynamicIsland.jsx) (Island display), [`src/services/bridge.js`](https://github.com/kailash2006/dynamic-island-desktop/blob/main/src/services/bridge.js) (Renderer bridge), [`src/App.jsx`](https://github.com/kailash2006/dynamic-island-desktop/blob/main/src/App.jsx) (Renderer app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_host["Desktop host"]
  node_electron["Electron host<br/>[main.cjs]"]
  node_preload["Preload bridge<br/>[preload.cjs]"]
  node_updater["Auto-updater<br/>[updater.cjs]"]
end

subgraph group_renderer["Island interface"]
  node_app["Renderer app<br/>[App.jsx]"]
  node_island["Island display<br/>[DynamicIsland.jsx]"]
  node_registry["Activity registry<br/>[registry.js]"]
  node_home["Feature menu<br/>[HomeActivity.jsx]"]
  node_panel["Control panel<br/>[ControlPanel.jsx]"]
  node_activity_views["Activity views"]
  node_glass_view["Glass rendering<br/>[Glass.jsx]"]
  node_visual_support["UI primitives<br/>[Primitives.jsx]"]
end

subgraph group_services["Activity services"]
  node_manager["Activity manager<br/>[activityManager.js]"]
  node_controllers["Activity controllers"]
  node_settings["Settings store<br/>[settings.js]"]
  node_stores["Shared state<br/>[stores.js]"]
  node_bridge["Renderer bridge<br/>[bridge.js]"]
end

subgraph group_integrations["Windows integrations"]
  node_media_integration["Media integration<br/>[media.cjs]"]
  node_notification_integration["Notification integration<br/>[notifications.cjs]"]
  node_backdrop_integration["Backdrop integration<br/>[backdrop.cjs]"]
  node_glass_capture["Glass capture<br/>[GlassCapture.cs]"]
end

node_user(("User"))
node_windows(("Windows"))
node_phone_link(("Phone Link"))

node_user -->|"opens panel"| node_electron
node_electron -->|"exposes bridge"| node_preload
node_preload -->|"provides API"| node_bridge
node_electron -.->|"loads renderer"| node_app
node_app -->|"renders"| node_island
node_app -->|"renders"| node_panel
node_user -->|"interacts"| node_island
node_island -->|"selects views"| node_registry
node_island -->|"reads and updates"| node_manager
node_island -->|"renders menu"| node_home
node_island -->|"renders backdrop"| node_glass_view
node_registry -->|"maps activity views"| node_activity_views
node_home -->|"starts activities"| node_manager
node_panel -->|"reads and updates"| node_settings
node_panel -->|"sends desktop commands"| node_bridge
node_activity_views -->|"uses primitives"| node_visual_support
node_controllers -->|"publishes activities"| node_manager
node_app -->|"initializes and routes events"| node_controllers
node_app -->|"updates backdrop"| node_stores
node_settings -->|"loads and persists"| node_bridge
node_electron -->|"configures"| node_media_integration
node_electron -->|"configures"| node_notification_integration
node_electron -->|"configures"| node_backdrop_integration
node_electron -->|"starts updates"| node_updater
node_media_integration -->|"reads media sessions"| node_windows
node_notification_integration -->|"reads notifications"| node_windows
node_phone_link -->|"forwards phone events"| node_windows
node_backdrop_integration -->|"captures windows"| node_glass_capture
node_glass_view -->|"reads backdrop"| node_stores
node_media_integration -.->|"sends media events"| node_bridge
node_notification_integration -.->|"sends notification events"| node_bridge
node_backdrop_integration -.->|"sends backdrop data"| node_bridge

click node_electron "https://github.com/kailash2006/dynamic-island-desktop/blob/main/electron/main.cjs"
click node_preload "https://github.com/kailash2006/dynamic-island-desktop/blob/main/electron/preload.cjs"
click node_updater "https://github.com/kailash2006/dynamic-island-desktop/blob/main/electron/updater.cjs"
click node_app "https://github.com/kailash2006/dynamic-island-desktop/blob/main/src/App.jsx"
click node_island "https://github.com/kailash2006/dynamic-island-desktop/blob/main/src/components/DynamicIsland/DynamicIsland.jsx"
click node_registry "https://github.com/kailash2006/dynamic-island-desktop/blob/main/src/components/registry.js"
click node_home "https://github.com/kailash2006/dynamic-island-desktop/blob/main/src/components/HomeActivity/HomeActivity.jsx"
click node_panel "https://github.com/kailash2006/dynamic-island-desktop/blob/main/src/components/ControlPanel/ControlPanel.jsx"
click node_activity_views "https://github.com/kailash2006/dynamic-island-desktop/tree/main/src/components"
click node_glass_view "https://github.com/kailash2006/dynamic-island-desktop/blob/main/src/components/DynamicIsland/Glass.jsx"
click node_visual_support "https://github.com/kailash2006/dynamic-island-desktop/blob/main/src/components/shared/Primitives.jsx"
click node_manager "https://github.com/kailash2006/dynamic-island-desktop/blob/main/src/services/activityManager.js"
click node_controllers "https://github.com/kailash2006/dynamic-island-desktop/tree/main/src/services/activities"
click node_settings "https://github.com/kailash2006/dynamic-island-desktop/blob/main/src/services/settings.js"
click node_stores "https://github.com/kailash2006/dynamic-island-desktop/blob/main/src/services/stores.js"
click node_bridge "https://github.com/kailash2006/dynamic-island-desktop/blob/main/src/services/bridge.js"
click node_media_integration "https://github.com/kailash2006/dynamic-island-desktop/blob/main/electron/integrations/media.cjs"
click node_notification_integration "https://github.com/kailash2006/dynamic-island-desktop/blob/main/electron/integrations/notifications.cjs"
click node_backdrop_integration "https://github.com/kailash2006/dynamic-island-desktop/blob/main/electron/integrations/backdrop.cjs"
click node_glass_capture "https://github.com/kailash2006/dynamic-island-desktop/blob/main/native/GlassCapture.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_electron,node_preload,node_updater,node_user toneBlue
class node_app,node_island,node_registry,node_home,node_panel,node_activity_views,node_glass_view,node_visual_support toneAmber
class node_manager,node_controllers,node_settings,node_stores,node_bridge toneMint
class node_media_integration,node_notification_integration,node_backdrop_integration,node_glass_capture toneRose
class node_windows,node_phone_link toneIndigo
```

## Components

### Desktop host

- [Electron host](https://github.com/kailash2006/dynamic-island-desktop/blob/main/electron/main.cjs): `electron/main.cjs`
- [Preload bridge](https://github.com/kailash2006/dynamic-island-desktop/blob/main/electron/preload.cjs): `electron/preload.cjs`
- [Auto-updater](https://github.com/kailash2006/dynamic-island-desktop/blob/main/electron/updater.cjs): `electron/updater.cjs`

### Island interface

- [Renderer app](https://github.com/kailash2006/dynamic-island-desktop/blob/main/src/App.jsx): `src/App.jsx`
- [Island display](https://github.com/kailash2006/dynamic-island-desktop/blob/main/src/components/DynamicIsland/DynamicIsland.jsx): `src/components/DynamicIsland/DynamicIsland.jsx`
- [Activity registry](https://github.com/kailash2006/dynamic-island-desktop/blob/main/src/components/registry.js): `src/components/registry.js`
- [Feature menu](https://github.com/kailash2006/dynamic-island-desktop/blob/main/src/components/HomeActivity/HomeActivity.jsx): `src/components/HomeActivity/HomeActivity.jsx`
- [Control panel](https://github.com/kailash2006/dynamic-island-desktop/blob/main/src/components/ControlPanel/ControlPanel.jsx): `src/components/ControlPanel/ControlPanel.jsx`
- [Activity views](https://github.com/kailash2006/dynamic-island-desktop/tree/main/src/components): `src/components`
- [Glass rendering](https://github.com/kailash2006/dynamic-island-desktop/blob/main/src/components/DynamicIsland/Glass.jsx): `src/components/DynamicIsland/Glass.jsx`
- [UI primitives](https://github.com/kailash2006/dynamic-island-desktop/blob/main/src/components/shared/Primitives.jsx): `src/components/shared/Primitives.jsx`

### Activity services

- [Activity manager](https://github.com/kailash2006/dynamic-island-desktop/blob/main/src/services/activityManager.js): `src/services/activityManager.js`
- [Activity controllers](https://github.com/kailash2006/dynamic-island-desktop/tree/main/src/services/activities): `src/services/activities`
- [Settings store](https://github.com/kailash2006/dynamic-island-desktop/blob/main/src/services/settings.js): `src/services/settings.js`
- [Shared state](https://github.com/kailash2006/dynamic-island-desktop/blob/main/src/services/stores.js): `src/services/stores.js`
- [Renderer bridge](https://github.com/kailash2006/dynamic-island-desktop/blob/main/src/services/bridge.js): `src/services/bridge.js`

### Windows integrations

- [Media integration](https://github.com/kailash2006/dynamic-island-desktop/blob/main/electron/integrations/media.cjs): `electron/integrations/media.cjs`
- [Notification integration](https://github.com/kailash2006/dynamic-island-desktop/blob/main/electron/integrations/notifications.cjs): `electron/integrations/notifications.cjs`
- [Backdrop integration](https://github.com/kailash2006/dynamic-island-desktop/blob/main/electron/integrations/backdrop.cjs): `electron/integrations/backdrop.cjs`
- [Glass capture](https://github.com/kailash2006/dynamic-island-desktop/blob/main/native/GlassCapture.cs): `native/GlassCapture.cs`

### Other components

- **User**
- **Windows**
- **Phone Link**

## Connections

- User → Electron host: opens panel (evidence: `README.md`)
- Electron host → Preload bridge: exposes bridge (evidence: `README.md`)
- Preload bridge → Renderer bridge: provides API (evidence: `README.md`)
- Electron host → Renderer app: loads renderer
- Renderer app → Island display: renders (evidence: `src/App.jsx`)
- Renderer app → Control panel: renders (evidence: `src/App.jsx`)
- User → Island display: interacts (evidence: `README.md`)
- Island display → Activity registry: selects views (evidence: `src/components/DynamicIsland/DynamicIsland.jsx`)
- Island display → Activity manager: reads and updates (evidence: `src/components/DynamicIsland/DynamicIsland.jsx`)
- Island display → Feature menu: renders menu (evidence: `src/components/DynamicIsland/DynamicIsland.jsx`)
- Island display → Glass rendering: renders backdrop (evidence: `src/components/DynamicIsland/DynamicIsland.jsx`)
- Activity registry → Activity views: maps activity views (evidence: `src/components/registry.js`)
- Feature menu → Activity manager: starts activities (evidence: `src/components/HomeActivity/HomeActivity.jsx`)
- Control panel → Settings store: reads and updates (evidence: `src/components/ControlPanel/ControlPanel.jsx`)
- Control panel → Renderer bridge: sends desktop commands (evidence: `src/components/ControlPanel/ControlPanel.jsx`)
- Activity views → UI primitives: uses primitives (evidence: `src/components/shared/Primitives.jsx`)
- Activity controllers → Activity manager: publishes activities (evidence: `src/services/activities/media.js`)
- Renderer app → Activity controllers: initializes and routes events (evidence: `src/App.jsx`)
- Renderer app → Shared state: updates backdrop (evidence: `src/App.jsx`)
- Settings store → Renderer bridge: loads and persists (evidence: `src/services/settings.js`)
- Electron host → Media integration: configures (evidence: `electron/main.cjs`)
- Electron host → Notification integration: configures (evidence: `electron/main.cjs`)
- Electron host → Backdrop integration: configures (evidence: `electron/main.cjs`)
- Electron host → Auto-updater: starts updates (evidence: `electron/main.cjs`)
- Media integration → Windows: reads media sessions (evidence: `README.md`)
- Notification integration → Windows: reads notifications (evidence: `README.md`)
- Phone Link → Windows: forwards phone events (evidence: `README.md`)
- Backdrop integration → Glass capture: captures windows (evidence: `README.md`)
- Glass rendering → Shared state: reads backdrop (evidence: `src/services/stores.js`)
- Media integration → Renderer bridge: sends media events
- Notification integration → Renderer bridge: sends notification events
- Backdrop integration → Renderer bridge: sends backdrop data
