How arusaky/dynamic-island- works
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: IslandBus.kt Activity state bus · IslandService.kt Accessibility service · IslandOverlay.kt Overlay manager · FeaturesScreen.kt Settings screens
Components 21
App and Settings
- Settings screens
app/src/main/java/com/akira/island/ui/screens/FeaturesScreen.kt - App entry
app/src/main/java/com/akira/island/ui/MainActivity.kt - Settings repository
app/src/main/java/com/akira/island/data/Settings.kt
Runtime Service
- Accessibility service
app/src/main/java/com/akira/island/service/IslandService.kt - Keep-alive service
app/src/main/java/com/akira/island/service/KeepAliveService.kt
Activity Sources
- Notification listener
app/src/main/java/com/akira/island/service/NotifListener.kt - Media monitor
app/src/main/java/com/akira/island/service/MediaMonitor.kt - Call monitor
app/src/main/java/com/akira/island/service/CallMonitor.kt - System events
app/src/main/java/com/akira/island/service/SystemEvents.kt - Payment monitor
app/src/main/java/com/akira/island/service/PayMonitor.kt - Face unlock
app/src/main/java/com/akira/island/face/FaceUnlockController.kt - Weather data
app/src/main/java/com/akira/island/service/WeatherRepo.kt - Lyrics lookup
app/src/main/java/com/akira/island/lyrics/LyricsRepo.kt
Shared State
- Activity state bus
app/src/main/java/com/akira/island/core/IslandBus.kt - Island controls
app/src/main/java/com/akira/island/core/Controls.kt
Island Display
- Overlay manager
app/src/main/java/com/akira/island/island/IslandOverlay.kt - Compact cards
app/src/main/java/com/akira/island/island/Compact.kt - Expanded cards
app/src/main/java/com/akira/island/island/Expanded.kt - Alarm creation
app/src/main/java/com/akira/island/core/system/AlarmCreation.kt
Other components
- Phone user
- Android system
Connections 20
- Phone user → App entry: opens app
README.md - App entry → Settings screens: presents settings
app/src/main/java/com/akira/island/ui/MainActivity.kt - Settings screens → Settings repository: configures
- Android system → Accessibility service: grants access
README.md - Accessibility service → Keep-alive service: starts
app/src/main/java/com/akira/island/service/IslandService.kt - Accessibility service → Overlay manager: creates windows
app/src/main/java/com/akira/island/service/IslandService.kt - Accessibility service → Activity state bus: reads state
app/src/main/java/com/akira/island/service/IslandService.kt - Accessibility service → Island controls: uses controls
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
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
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
README.md - Android system → Notification listener: delivers notifications
README.md