# arusaky/dynamic-island- architecture

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

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

## Overview

Dynamic Island is an Android overlay that turns phone activity into compact and expanded, interactive cards. The main user workflow is to grant accessibility and notification access, configure appearance and behavior, then let the running service surface supported events. The README documents broad capabilities, while sampled service code and the source index confirm the service’s role and several internal dependencies. Many feature-specific monitor-to-state-to-card connections were not sampled, so those links are omitted rather than inferred.

Main entry points: [`app/src/main/java/com/akira/island/core/IslandBus.kt`](https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/core/IslandBus.kt) (Activity state bus), [`app/src/main/java/com/akira/island/service/IslandService.kt`](https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/service/IslandService.kt) (Accessibility service), [`app/src/main/java/com/akira/island/island/IslandOverlay.kt`](https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/island/IslandOverlay.kt) (Overlay manager), [`app/src/main/java/com/akira/island/ui/screens/FeaturesScreen.kt`](https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/ui/screens/FeaturesScreen.kt) (Settings screens)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["App and Settings"]
  node_settings_ui["Settings screens<br/>[FeaturesScreen.kt]"]
  node_main_activity["App entry<br/>[MainActivity.kt]"]
  node_settings[("Settings repository<br/>[Settings.kt]")]
end

subgraph group_runtime["Runtime Service"]
  node_island_service["Accessibility service<br/>[IslandService.kt]"]
  node_keepalive["Keep-alive service"]
end

subgraph group_events["Activity Sources"]
  node_notification_listener["Notification listener<br/>[NotifListener.kt]"]
  node_media_monitor["Media monitor<br/>[MediaMonitor.kt]"]
  node_call_monitor["Call monitor<br/>[CallMonitor.kt]"]
  node_system_events["System events<br/>[SystemEvents.kt]"]
  node_payments["Payment monitor<br/>[PayMonitor.kt]"]
  node_face["Face unlock"]
  node_weather["Weather data<br/>[WeatherRepo.kt]"]
  node_lyrics["Lyrics lookup<br/>[LyricsRepo.kt]"]
end

subgraph group_state["Shared State"]
  node_bus[("Activity state bus<br/>[IslandBus.kt]")]
  node_controls["Island controls<br/>[Controls.kt]"]
end

subgraph group_display["Island Display"]
  node_overlay["Overlay manager<br/>[IslandOverlay.kt]"]
  node_compact["Compact cards<br/>[Compact.kt]"]
  node_expanded["Expanded cards<br/>[Expanded.kt]"]
  node_alarm["Alarm creation<br/>[AlarmCreation.kt]"]
end

node_user(("Phone user"))
node_android(("Android system"))

node_user -->|"opens app"| node_main_activity
node_main_activity -->|"presents settings"| node_settings_ui
node_settings_ui -.->|"configures"| node_settings
node_android -->|"grants access"| node_island_service
node_island_service -->|"starts"| node_keepalive
node_island_service -->|"creates windows"| node_overlay
node_island_service -->|"reads state"| node_bus
node_island_service -->|"uses controls"| node_controls
node_notification_listener -.->|"publishes notices"| node_bus
node_media_monitor -.->|"publishes media"| node_bus
node_call_monitor -->|"publishes calls"| node_bus
node_system_events -.->|"publishes events"| node_bus
node_payments -.->|"publishes payment"| node_bus
node_face -->|"publishes recognition"| node_bus
node_lyrics -.->|"supplies lyrics"| node_bus
node_weather -.->|"supplies weather"| node_bus
node_overlay -->|"renders"| node_compact
node_overlay -->|"renders"| node_expanded
node_user -->|"creates alarm"| node_alarm
node_android -->|"delivers notifications"| node_notification_listener

click node_settings_ui "https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/ui/screens/FeaturesScreen.kt"
click node_main_activity "https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/ui/MainActivity.kt"
click node_settings "https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/data/Settings.kt"
click node_island_service "https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/service/IslandService.kt"
click node_keepalive "https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/service/KeepAliveService.kt"
click node_notification_listener "https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/service/NotifListener.kt"
click node_media_monitor "https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/service/MediaMonitor.kt"
click node_call_monitor "https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/service/CallMonitor.kt"
click node_system_events "https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/service/SystemEvents.kt"
click node_payments "https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/service/PayMonitor.kt"
click node_face "https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/face/FaceUnlockController.kt"
click node_weather "https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/service/WeatherRepo.kt"
click node_lyrics "https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/lyrics/LyricsRepo.kt"
click node_bus "https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/core/IslandBus.kt"
click node_controls "https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/core/Controls.kt"
click node_overlay "https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/island/IslandOverlay.kt"
click node_compact "https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/island/Compact.kt"
click node_expanded "https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/island/Expanded.kt"
click node_alarm "https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/core/system/AlarmCreation.kt"

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_settings_ui,node_main_activity,node_settings,node_user toneBlue
class node_island_service,node_keepalive toneAmber
class node_notification_listener,node_media_monitor,node_call_monitor,node_system_events,node_payments,node_face,node_weather,node_lyrics toneMint
class node_bus,node_controls toneRose
class node_overlay,node_compact,node_expanded,node_alarm,node_android toneIndigo
```

## Components

### App and Settings

- [Settings screens](https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/ui/screens/FeaturesScreen.kt): `app/src/main/java/com/akira/island/ui/screens/FeaturesScreen.kt`
- [App entry](https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/ui/MainActivity.kt): `app/src/main/java/com/akira/island/ui/MainActivity.kt`
- [Settings repository](https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/data/Settings.kt): `app/src/main/java/com/akira/island/data/Settings.kt`

### Runtime Service

- [Accessibility service](https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/service/IslandService.kt): `app/src/main/java/com/akira/island/service/IslandService.kt`
- [Keep-alive service](https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/service/KeepAliveService.kt): `app/src/main/java/com/akira/island/service/KeepAliveService.kt`

### Activity Sources

- [Notification listener](https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/service/NotifListener.kt): `app/src/main/java/com/akira/island/service/NotifListener.kt`
- [Media monitor](https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/service/MediaMonitor.kt): `app/src/main/java/com/akira/island/service/MediaMonitor.kt`
- [Call monitor](https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/service/CallMonitor.kt): `app/src/main/java/com/akira/island/service/CallMonitor.kt`
- [System events](https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/service/SystemEvents.kt): `app/src/main/java/com/akira/island/service/SystemEvents.kt`
- [Payment monitor](https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/service/PayMonitor.kt): `app/src/main/java/com/akira/island/service/PayMonitor.kt`
- [Face unlock](https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/face/FaceUnlockController.kt): `app/src/main/java/com/akira/island/face/FaceUnlockController.kt`
- [Weather data](https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/service/WeatherRepo.kt): `app/src/main/java/com/akira/island/service/WeatherRepo.kt`
- [Lyrics lookup](https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/lyrics/LyricsRepo.kt): `app/src/main/java/com/akira/island/lyrics/LyricsRepo.kt`

### Shared State

- [Activity state bus](https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/core/IslandBus.kt): `app/src/main/java/com/akira/island/core/IslandBus.kt`
- [Island controls](https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/core/Controls.kt): `app/src/main/java/com/akira/island/core/Controls.kt`

### Island Display

- [Overlay manager](https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/island/IslandOverlay.kt): `app/src/main/java/com/akira/island/island/IslandOverlay.kt`
- [Compact cards](https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/island/Compact.kt): `app/src/main/java/com/akira/island/island/Compact.kt`
- [Expanded cards](https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/island/Expanded.kt): `app/src/main/java/com/akira/island/island/Expanded.kt`
- [Alarm creation](https://github.com/arusaky/dynamic-island-/blob/claude/android-dynamic-island-yrzsvq/app/src/main/java/com/akira/island/core/system/AlarmCreation.kt): `app/src/main/java/com/akira/island/core/system/AlarmCreation.kt`

### Other components

- **Phone user**
- **Android system**

## Connections

- Phone user → App entry: opens app (evidence: `README.md`)
- App entry → Settings screens: presents settings (evidence: `app/src/main/java/com/akira/island/ui/MainActivity.kt`)
- Settings screens → Settings repository: configures
- Android system → Accessibility service: grants access (evidence: `README.md`)
- Accessibility service → Keep-alive service: starts (evidence: `app/src/main/java/com/akira/island/service/IslandService.kt`)
- Accessibility service → Overlay manager: creates windows (evidence: `app/src/main/java/com/akira/island/service/IslandService.kt`)
- Accessibility service → Activity state bus: reads state (evidence: `app/src/main/java/com/akira/island/service/IslandService.kt`)
- Accessibility service → Island controls: uses controls (evidence: `app/src/main/java/com/akira/island/service/IslandService.kt`)
- Notification listener → Activity state bus: publishes notices
- Media monitor → Activity state bus: publishes media
- Call monitor → Activity state bus: publishes calls (evidence: `app/src/main/java/com/akira/island/service/CallMonitor.kt`)
- System events → Activity state bus: publishes events
- Payment monitor → Activity state bus: publishes payment
- Face unlock → Activity state bus: publishes recognition (evidence: `app/src/main/java/com/akira/island/face/FaceUnlockController.kt`)
- Lyrics lookup → Activity state bus: supplies lyrics
- Weather data → Activity state bus: supplies weather
- Overlay manager → Compact cards: renders
- Overlay manager → Expanded cards: renders
- Phone user → Alarm creation: creates alarm (evidence: `README.md`)
- Android system → Notification listener: delivers notifications (evidence: `README.md`)
