# rdzn00/ai-dynamic-island- architecture

> Architecture diagram of the GitHub repository rdzn00/ai-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/rdzn00/ai-dynamic-island-
- Repository: https://github.com/rdzn00/ai-dynamic-island-

## Overview

Mochi is an Android dynamic-island companion: users configure the overlay and app filtering, while Android accessibility and notification services supply device and notification events that the overlay presents. The UI also exposes device statistics, settings/tools, media controls, and notification replies. The shared Bus is the internal state and preference layer. The README describes the Android project but not its runtime features; subsystem details and edges below rely on the sampled excerpts and SOURCE INDEX references, so unsampled behavior is not inferred.

Main entry points: [`app/src/main/java/com/aiisland/app/Screens.kt`](https://github.com/rdzn00/ai-dynamic-island-/blob/main/app/src/main/java/com/aiisland/app/Screens.kt) (App screens), [`app/src/main/java/com/aiisland/app/Bus.kt`](https://github.com/rdzn00/ai-dynamic-island-/blob/main/app/src/main/java/com/aiisland/app/Bus.kt) (State and preferences), [`app/src/main/java/com/aiisland/app/Island.kt`](https://github.com/rdzn00/ai-dynamic-island-/blob/main/app/src/main/java/com/aiisland/app/Island.kt) (Dynamic island), [`app/src/main/java/com/aiisland/app/MainActivity.kt`](https://github.com/rdzn00/ai-dynamic-island-/blob/main/app/src/main/java/com/aiisland/app/MainActivity.kt) (App entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app_ui["App interface"]
  node_main["App entry<br/>[MainActivity.kt]"]
  node_screens["App screens<br/>[Screens.kt]"]
  node_picker["App picker<br/>[AppPicker.kt]"]
  node_reply["Reply UI<br/>[ReplyActivity.kt]"]
  node_stats["Device statistics<br/>[Stats.kt]"]
  node_strings["Localization<br/>[Strings.kt]"]
  node_theme["UI theme<br/>[Theme.kt]"]
end

subgraph group_overlay["Island overlay"]
  node_island_service["Overlay service<br/>[IslandService.kt]"]
  node_island["Dynamic island<br/>[Island.kt]"]
  node_robot["Mochi character<br/>[Robot.kt]"]
end

subgraph group_events["Device events"]
  node_notification_service["Notification listener"]
  node_mood["Device mood<br/>[Mood.kt]"]
end

subgraph group_shared["Shared state"]
  node_bus["State and preferences<br/>[Bus.kt]"]
end

node_user(("User"))
node_android["Android system"]

node_user -.->|"opens"| node_main
node_main -->|"loads preferences"| node_bus
node_main -->|"displays"| node_screens
node_main -->|"opens"| node_picker
node_main -->|"checks status"| node_island_service
node_screens -->|"reads statistics"| node_stats
node_screens -->|"reads and updates"| node_bus
node_screens -->|"renders"| node_robot
node_screens -->|"uses moods"| node_mood
node_screens -->|"uses island UI"| node_island
node_screens -->|"localizes text"| node_strings
node_island_service -->|"updates state"| node_bus
node_island_service -->|"uses device state"| node_mood
node_island_service -->|"shows overlay"| node_island
node_island -->|"reads and dispatches"| node_bus
node_island -->|"renders"| node_robot
node_island -->|"uses moods"| node_mood
node_island -->|"opens reply flow"| node_reply
node_notification_service -->|"publishes notifications and media"| node_bus
node_reply -->|"sends reply"| node_bus
node_bus -->|"uses mood type"| node_mood
node_android -.->|"provides device events"| node_island_service
node_android -.->|"provides notifications and media sessions"| node_notification_service

click node_main "https://github.com/rdzn00/ai-dynamic-island-/blob/main/app/src/main/java/com/aiisland/app/MainActivity.kt"
click node_screens "https://github.com/rdzn00/ai-dynamic-island-/blob/main/app/src/main/java/com/aiisland/app/Screens.kt"
click node_picker "https://github.com/rdzn00/ai-dynamic-island-/blob/main/app/src/main/java/com/aiisland/app/AppPicker.kt"
click node_reply "https://github.com/rdzn00/ai-dynamic-island-/blob/main/app/src/main/java/com/aiisland/app/ReplyActivity.kt"
click node_stats "https://github.com/rdzn00/ai-dynamic-island-/blob/main/app/src/main/java/com/aiisland/app/Stats.kt"
click node_strings "https://github.com/rdzn00/ai-dynamic-island-/blob/main/app/src/main/java/com/aiisland/app/Strings.kt"
click node_theme "https://github.com/rdzn00/ai-dynamic-island-/blob/main/app/src/main/java/com/aiisland/app/Theme.kt"
click node_island_service "https://github.com/rdzn00/ai-dynamic-island-/blob/main/app/src/main/java/com/aiisland/app/IslandService.kt"
click node_island "https://github.com/rdzn00/ai-dynamic-island-/blob/main/app/src/main/java/com/aiisland/app/Island.kt"
click node_robot "https://github.com/rdzn00/ai-dynamic-island-/blob/main/app/src/main/java/com/aiisland/app/Robot.kt"
click node_notification_service "https://github.com/rdzn00/ai-dynamic-island-/blob/main/app/src/main/java/com/aiisland/app/NotificationService.kt"
click node_mood "https://github.com/rdzn00/ai-dynamic-island-/blob/main/app/src/main/java/com/aiisland/app/Mood.kt"
click node_bus "https://github.com/rdzn00/ai-dynamic-island-/blob/main/app/src/main/java/com/aiisland/app/Bus.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_main,node_screens,node_picker,node_reply,node_stats,node_strings,node_theme,node_user toneBlue
class node_island_service,node_island,node_robot toneAmber
class node_notification_service,node_mood toneMint
class node_bus toneRose
class node_android toneIndigo
```

## Components

### App interface

- [App entry](https://github.com/rdzn00/ai-dynamic-island-/blob/main/app/src/main/java/com/aiisland/app/MainActivity.kt): `app/src/main/java/com/aiisland/app/MainActivity.kt`
- [App screens](https://github.com/rdzn00/ai-dynamic-island-/blob/main/app/src/main/java/com/aiisland/app/Screens.kt): `app/src/main/java/com/aiisland/app/Screens.kt`
- [App picker](https://github.com/rdzn00/ai-dynamic-island-/blob/main/app/src/main/java/com/aiisland/app/AppPicker.kt): `app/src/main/java/com/aiisland/app/AppPicker.kt`
- [Reply UI](https://github.com/rdzn00/ai-dynamic-island-/blob/main/app/src/main/java/com/aiisland/app/ReplyActivity.kt): `app/src/main/java/com/aiisland/app/ReplyActivity.kt`
- [Device statistics](https://github.com/rdzn00/ai-dynamic-island-/blob/main/app/src/main/java/com/aiisland/app/Stats.kt): `app/src/main/java/com/aiisland/app/Stats.kt`
- [Localization](https://github.com/rdzn00/ai-dynamic-island-/blob/main/app/src/main/java/com/aiisland/app/Strings.kt): `app/src/main/java/com/aiisland/app/Strings.kt`
- [UI theme](https://github.com/rdzn00/ai-dynamic-island-/blob/main/app/src/main/java/com/aiisland/app/Theme.kt): `app/src/main/java/com/aiisland/app/Theme.kt`

### Island overlay

- [Overlay service](https://github.com/rdzn00/ai-dynamic-island-/blob/main/app/src/main/java/com/aiisland/app/IslandService.kt): `app/src/main/java/com/aiisland/app/IslandService.kt`
- [Dynamic island](https://github.com/rdzn00/ai-dynamic-island-/blob/main/app/src/main/java/com/aiisland/app/Island.kt): `app/src/main/java/com/aiisland/app/Island.kt`
- [Mochi character](https://github.com/rdzn00/ai-dynamic-island-/blob/main/app/src/main/java/com/aiisland/app/Robot.kt): `app/src/main/java/com/aiisland/app/Robot.kt`

### Device events

- [Notification listener](https://github.com/rdzn00/ai-dynamic-island-/blob/main/app/src/main/java/com/aiisland/app/NotificationService.kt): `app/src/main/java/com/aiisland/app/NotificationService.kt`
- [Device mood](https://github.com/rdzn00/ai-dynamic-island-/blob/main/app/src/main/java/com/aiisland/app/Mood.kt): `app/src/main/java/com/aiisland/app/Mood.kt`

### Shared state

- [State and preferences](https://github.com/rdzn00/ai-dynamic-island-/blob/main/app/src/main/java/com/aiisland/app/Bus.kt): `app/src/main/java/com/aiisland/app/Bus.kt`

### Other components

- **User**
- **Android system**

## Connections

- User → App entry: opens
- App entry → State and preferences: loads preferences (evidence: `app/src/main/java/com/aiisland/app/MainActivity.kt`)
- App entry → App screens: displays (evidence: `app/src/main/java/com/aiisland/app/MainActivity.kt`)
- App entry → App picker: opens (evidence: `app/src/main/java/com/aiisland/app/MainActivity.kt`)
- App entry → Overlay service: checks status (evidence: `app/src/main/java/com/aiisland/app/MainActivity.kt`)
- App screens → Device statistics: reads statistics (evidence: `app/src/main/java/com/aiisland/app/Screens.kt`)
- App screens → State and preferences: reads and updates (evidence: `app/src/main/java/com/aiisland/app/Screens.kt`)
- App screens → Mochi character: renders (evidence: `app/src/main/java/com/aiisland/app/Screens.kt`)
- App screens → Device mood: uses moods (evidence: `app/src/main/java/com/aiisland/app/Screens.kt`)
- App screens → Dynamic island: uses island UI (evidence: `app/src/main/java/com/aiisland/app/Screens.kt`)
- App screens → Localization: localizes text (evidence: `app/src/main/java/com/aiisland/app/Screens.kt`)
- Overlay service → State and preferences: updates state (evidence: `app/src/main/java/com/aiisland/app/IslandService.kt`)
- Overlay service → Device mood: uses device state (evidence: `app/src/main/java/com/aiisland/app/IslandService.kt`)
- Overlay service → Dynamic island: shows overlay (evidence: `app/src/main/java/com/aiisland/app/IslandService.kt`)
- Dynamic island → State and preferences: reads and dispatches (evidence: `app/src/main/java/com/aiisland/app/Island.kt`)
- Dynamic island → Mochi character: renders (evidence: `app/src/main/java/com/aiisland/app/Island.kt`)
- Dynamic island → Device mood: uses moods (evidence: `app/src/main/java/com/aiisland/app/Island.kt`)
- Dynamic island → Reply UI: opens reply flow (evidence: `app/src/main/java/com/aiisland/app/Island.kt`)
- Notification listener → State and preferences: publishes notifications and media (evidence: `app/src/main/java/com/aiisland/app/NotificationService.kt`)
- Reply UI → State and preferences: sends reply (evidence: `app/src/main/java/com/aiisland/app/ReplyActivity.kt`)
- State and preferences → Device mood: uses mood type (evidence: `app/src/main/java/com/aiisland/app/Bus.kt`)
- Android system → Overlay service: provides device events
- Android system → Notification listener: provides notifications and media sessions
