# kishank00172/project_hyper_island_pro architecture

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

- Interactive diagram: https://gitdiagram.com/kishank00172/project_hyper_island_pro
- Repository: https://github.com/kishank00172/project_hyper_island_pro

## Overview

Hyper Island Pro is an Android notification-island app: notifications are captured and interpreted, then the accessibility service manages the island’s presentation and motion. Users enter through the home screen to check permissions, configure behavior, and inspect traces or test controls. The README describes a Phase 0 foundation, while the indexed source files show substantial later-phase notification, overlay, and motion code; unsampled implementation details are represented only where the index or README supports them.

Main entry points: [`app/src/main/java/com/hyperisland/pro/services/HyperAccessibilityService.kt`](https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/services/HyperAccessibilityService.kt) (Island controller), [`app/src/main/java/com/hyperisland/pro/services/HyperNotificationListenerService.kt`](https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/services/HyperNotificationListenerService.kt) (Notification listener), [`app/src/main/java/com/hyperisland/pro/MainActivity.kt`](https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/MainActivity.kt) (Home screen), [`app/src/main/java/com/hyperisland/pro/ui/TestLabActivity.kt`](https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/ui/TestLabActivity.kt) (Test Lab)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App entry and controls"]
  node_home["Home screen<br/>[MainActivity.kt]"]
  node_permissions["Permission Doctor"]
  node_settings["Settings"]
  node_testlab["Test Lab<br/>[TestLabActivity.kt]"]
  node_traceui["Trace viewer"]
end

subgraph group_capture["Notification capture"]
  node_listener["Notification listener"]
  node_extractor["Notification parsing"]
  node_chatpolicy["Chat display policy"]
  node_identity["Conversation identity"]
  node_echo["Reply echo suppression"]
  node_icons["Pill icon cache<br/>[PillIconCache.kt]"]
end

subgraph group_runtime["Island runtime"]
  node_accessibility["Island controller"]
  node_overlay["Overlay service"]
  node_pager["Pager dial view<br/>[PagerDialView.kt]"]
end

subgraph group_core["Policy and diagnostics"]
  node_settingsdata[("App preferences<br/>[AppSettings.kt]")]
  node_motion["Motion variants<br/>[MotionVariant.kt]"]
  node_morph["Morph frame"]
  node_gesture["Island gestures<br/>[IslandGesture.kt]"]
  node_framewatch["Frame monitoring<br/>[FrameWatch.kt]"]
  node_tracelog[("Trace buffer<br/>[TraceLog.kt]")]
end

node_user(("User"))
node_android["Android system"]
node_apps["Notifying apps"]

node_user -->|"opens app"| node_home
node_home -->|"opens"| node_permissions
node_home -->|"opens"| node_settings
node_home -->|"opens"| node_testlab
node_home -->|"opens"| node_traceui
node_permissions -->|"checks permissions"| node_android
node_settings -->|"reads and writes"| node_settingsdata
node_settings -->|"refreshes service"| node_overlay
node_testlab -->|"adjusts settings"| node_settingsdata
node_testlab -->|"triggers controls"| node_accessibility
node_testlab -->|"reads trace"| node_tracelog
node_apps -->|"posts notifications"| node_listener
node_android -->|"delivers events"| node_listener
node_listener -->|"parses content"| node_extractor
node_listener -->|"checks reply echoes"| node_echo
node_extractor -->|"applies display rules"| node_chatpolicy
node_extractor -->|"resolves conversations"| node_identity
node_listener -->|"forwards notifications"| node_accessibility
node_listener -->|"loads icons"| node_icons
node_android -->|"sends events"| node_accessibility
node_accessibility -->|"reads preferences"| node_settingsdata
node_accessibility -->|"uses chat rules"| node_chatpolicy
node_accessibility -->|"selects motion"| node_motion
node_accessibility -.->|"animates morph"| node_morph
node_accessibility -->|"handles gestures"| node_gesture
node_accessibility -.->|"displays pager"| node_pager
node_accessibility -->|"monitors frames"| node_framewatch
node_accessibility -->|"records events"| node_tracelog
node_overlay -->|"refreshes island"| node_accessibility
node_settingsdata -->|"clamps style"| node_motion
node_traceui -->|"reads and exports"| node_tracelog

click node_home "https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/MainActivity.kt"
click node_permissions "https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/ui/PermissionDoctorActivity.kt"
click node_settings "https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/ui/SettingsActivity.kt"
click node_testlab "https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/ui/TestLabActivity.kt"
click node_listener "https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/services/HyperNotificationListenerService.kt"
click node_extractor "https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/services/NotificationContentExtractor.kt"
click node_chatpolicy "https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/core/ChatDisplayPolicy.kt"
click node_identity "https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/core/ConversationIdentity.kt"
click node_echo "https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/services/ReplyEchoSuppressor.kt"
click node_icons "https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/services/PillIconCache.kt"
click node_accessibility "https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/services/HyperAccessibilityService.kt"
click node_overlay "https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/services/IslandOverlayService.kt"
click node_pager "https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/services/PagerDialView.kt"
click node_settingsdata "https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/core/AppSettings.kt"
click node_motion "https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/core/MotionVariant.kt"
click node_morph "https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/core/IslandMorphFrame.kt"
click node_gesture "https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/core/IslandGesture.kt"
click node_framewatch "https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/core/FrameWatch.kt"
click node_tracelog "https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/core/TraceLog.kt"
click node_traceui "https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/ui/TraceLogActivity.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_home,node_permissions,node_settings,node_testlab,node_traceui,node_user toneBlue
class node_listener,node_extractor,node_chatpolicy,node_identity,node_echo,node_icons toneAmber
class node_accessibility,node_overlay,node_pager toneMint
class node_settingsdata,node_motion,node_morph,node_gesture,node_framewatch,node_tracelog toneRose
class node_android,node_apps toneIndigo
```

## Components

### App entry and controls

- [Home screen](https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/MainActivity.kt): `app/src/main/java/com/hyperisland/pro/MainActivity.kt`
- [Permission Doctor](https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/ui/PermissionDoctorActivity.kt): `app/src/main/java/com/hyperisland/pro/ui/PermissionDoctorActivity.kt`
- [Settings](https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/ui/SettingsActivity.kt): `app/src/main/java/com/hyperisland/pro/ui/SettingsActivity.kt`
- [Test Lab](https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/ui/TestLabActivity.kt): `app/src/main/java/com/hyperisland/pro/ui/TestLabActivity.kt`
- [Trace viewer](https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/ui/TraceLogActivity.kt): `app/src/main/java/com/hyperisland/pro/ui/TraceLogActivity.kt`

### Notification capture

- [Notification listener](https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/services/HyperNotificationListenerService.kt): `app/src/main/java/com/hyperisland/pro/services/HyperNotificationListenerService.kt`
- [Notification parsing](https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/services/NotificationContentExtractor.kt): `app/src/main/java/com/hyperisland/pro/services/NotificationContentExtractor.kt`
- [Chat display policy](https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/core/ChatDisplayPolicy.kt): `app/src/main/java/com/hyperisland/pro/core/ChatDisplayPolicy.kt`
- [Conversation identity](https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/core/ConversationIdentity.kt): `app/src/main/java/com/hyperisland/pro/core/ConversationIdentity.kt`
- [Reply echo suppression](https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/services/ReplyEchoSuppressor.kt): `app/src/main/java/com/hyperisland/pro/services/ReplyEchoSuppressor.kt`
- [Pill icon cache](https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/services/PillIconCache.kt): `app/src/main/java/com/hyperisland/pro/services/PillIconCache.kt`

### Island runtime

- [Island controller](https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/services/HyperAccessibilityService.kt): `app/src/main/java/com/hyperisland/pro/services/HyperAccessibilityService.kt`
- [Overlay service](https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/services/IslandOverlayService.kt): `app/src/main/java/com/hyperisland/pro/services/IslandOverlayService.kt`
- [Pager dial view](https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/services/PagerDialView.kt): `app/src/main/java/com/hyperisland/pro/services/PagerDialView.kt`

### Policy and diagnostics

- [App preferences](https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/core/AppSettings.kt): `app/src/main/java/com/hyperisland/pro/core/AppSettings.kt`
- [Motion variants](https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/core/MotionVariant.kt): `app/src/main/java/com/hyperisland/pro/core/MotionVariant.kt`
- [Morph frame](https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/core/IslandMorphFrame.kt): `app/src/main/java/com/hyperisland/pro/core/IslandMorphFrame.kt`
- [Island gestures](https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/core/IslandGesture.kt): `app/src/main/java/com/hyperisland/pro/core/IslandGesture.kt`
- [Frame monitoring](https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/core/FrameWatch.kt): `app/src/main/java/com/hyperisland/pro/core/FrameWatch.kt`
- [Trace buffer](https://github.com/kishank00172/project_hyper_island_pro/blob/main/app/src/main/java/com/hyperisland/pro/core/TraceLog.kt): `app/src/main/java/com/hyperisland/pro/core/TraceLog.kt`

### Other components

- **User**
- **Android system**
- **Notifying apps**

## Connections

- User → Home screen: opens app (evidence: `app/src/main/java/com/hyperisland/pro/MainActivity.kt`)
- Home screen → Permission Doctor: opens (evidence: `app/src/main/java/com/hyperisland/pro/MainActivity.kt`)
- Home screen → Settings: opens (evidence: `app/src/main/java/com/hyperisland/pro/MainActivity.kt`)
- Home screen → Test Lab: opens (evidence: `app/src/main/java/com/hyperisland/pro/MainActivity.kt`)
- Home screen → Trace viewer: opens (evidence: `app/src/main/java/com/hyperisland/pro/MainActivity.kt`)
- Permission Doctor → Android system: checks permissions (evidence: `app/src/main/java/com/hyperisland/pro/ui/PermissionDoctorActivity.kt`)
- Settings → App preferences: reads and writes (evidence: `app/src/main/java/com/hyperisland/pro/ui/SettingsActivity.kt`)
- Settings → Overlay service: refreshes service (evidence: `app/src/main/java/com/hyperisland/pro/ui/SettingsActivity.kt`)
- Test Lab → App preferences: adjusts settings (evidence: `app/src/main/java/com/hyperisland/pro/ui/TestLabActivity.kt`)
- Test Lab → Island controller: triggers controls (evidence: `app/src/main/java/com/hyperisland/pro/ui/TestLabActivity.kt`)
- Test Lab → Trace buffer: reads trace (evidence: `app/src/main/java/com/hyperisland/pro/ui/TestLabActivity.kt`)
- Notifying apps → Notification listener: posts notifications (evidence: `app/src/main/java/com/hyperisland/pro/services/HyperNotificationListenerService.kt`)
- Android system → Notification listener: delivers events (evidence: `app/src/main/java/com/hyperisland/pro/services/HyperNotificationListenerService.kt`)
- Notification listener → Notification parsing: parses content (evidence: `app/src/main/java/com/hyperisland/pro/services/HyperNotificationListenerService.kt`)
- Notification listener → Reply echo suppression: checks reply echoes (evidence: `app/src/main/java/com/hyperisland/pro/services/HyperNotificationListenerService.kt`)
- Notification parsing → Chat display policy: applies display rules (evidence: `app/src/main/java/com/hyperisland/pro/services/NotificationContentExtractor.kt`)
- Notification parsing → Conversation identity: resolves conversations (evidence: `app/src/main/java/com/hyperisland/pro/services/NotificationContentExtractor.kt`)
- Notification listener → Island controller: forwards notifications (evidence: `app/src/main/java/com/hyperisland/pro/services/HyperNotificationListenerService.kt`)
- Notification listener → Pill icon cache: loads icons (evidence: `app/src/main/java/com/hyperisland/pro/services/HyperNotificationListenerService.kt`)
- Android system → Island controller: sends events (evidence: `app/src/main/java/com/hyperisland/pro/services/HyperAccessibilityService.kt`)
- Island controller → App preferences: reads preferences (evidence: `app/src/main/java/com/hyperisland/pro/services/HyperAccessibilityService.kt`)
- Island controller → Chat display policy: uses chat rules (evidence: `app/src/main/java/com/hyperisland/pro/services/HyperAccessibilityService.kt`)
- Island controller → Motion variants: selects motion (evidence: `app/src/main/java/com/hyperisland/pro/services/HyperAccessibilityService.kt`)
- Island controller → Morph frame: animates morph (evidence: `app/src/main/java/com/hyperisland/pro/services/HyperAccessibilityService.kt`)
- Island controller → Island gestures: handles gestures (evidence: `app/src/main/java/com/hyperisland/pro/services/HyperAccessibilityService.kt`)
- Island controller → Pager dial view: displays pager (evidence: `app/src/main/java/com/hyperisland/pro/services/HyperAccessibilityService.kt`)
- Island controller → Frame monitoring: monitors frames (evidence: `app/src/main/java/com/hyperisland/pro/services/HyperAccessibilityService.kt`)
- Island controller → Trace buffer: records events (evidence: `app/src/main/java/com/hyperisland/pro/services/HyperAccessibilityService.kt`)
- Overlay service → Island controller: refreshes island (evidence: `app/src/main/java/com/hyperisland/pro/services/IslandOverlayService.kt`)
- App preferences → Motion variants: clamps style (evidence: `app/src/main/java/com/hyperisland/pro/core/AppSettings.kt`)
- Trace viewer → Trace buffer: reads and exports (evidence: `app/src/main/java/com/hyperisland/pro/ui/TraceLogActivity.kt`)
