# shimmerfly/accesshub architecture

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

- Interactive diagram: https://gitdiagram.com/shimmerfly/accesshub
- Repository: https://github.com/shimmerfly/accesshub

## Overview

AccessHub is an Android app for discovering installed accessibility services and centrally enabling or disabling them through Shizuku/Sui shell privileges. The user enters the app, reviews services and their enabled state, then requests a change; the repository writes the enabled set through a Shizuku user service. The README also identifies home, settings, about, and color-palette screens, plus dual Material/Miuix presentation. Several screen implementations were not sampled, so their internal calls are not asserted.

Main entry points: [`app/src/main/java/dev/sol/accesshub/ui/MainActivity.kt`](https://github.com/shimmerfly/accesshub/blob/AccessHub/app/src/main/java/dev/sol/accesshub/ui/MainActivity.kt) (Activity and navigation), [`app/src/main/java/dev/sol/accesshub/data/repository/AccessibilityRepository.kt`](https://github.com/shimmerfly/accesshub/blob/AccessHub/app/src/main/java/dev/sol/accesshub/data/repository/AccessibilityRepository.kt) (Service repository), [`app/src/main/java/dev/sol/accesshub/ui/screen/settings`](https://github.com/shimmerfly/accesshub/tree/AccessHub/app/src/main/java/dev/sol/accesshub/ui/screen/settings) (Settings screen), [`app/src/main/java/dev/sol/accesshub/shizuku/ShizukuManager.kt`](https://github.com/shimmerfly/accesshub/blob/AccessHub/app/src/main/java/dev/sol/accesshub/shizuku/ShizukuManager.kt) (Provider status and permission)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Application UI"]
  node_main["Activity and navigation<br/>[MainActivity.kt]"]
  node_navigator["Route navigator<br/>[Navigator.kt]"]
  node_home["Home screen"]
  node_service_screen["Accessibility screen"]
  node_settings_screen["Settings screen"]
  node_about_palette["About and palette"]
  node_bottom_bar["Navigation bars<br/>[BottomBar.kt]"]
  node_ui_mode["UI mode<br/>[UiMode.kt]"]
end

subgraph group_domain["Accessibility Domain"]
  node_access_repo["Service repository"]
  node_service_meta["Service metadata<br/>[ServiceMeta.kt]"]
  node_enabled_counter["Enabled-service badge"]
end

subgraph group_privilege["Privilege Bridge"]
  node_shizuku_manager["Provider status and permission<br/>[ShizukuManager.kt]"]
  node_shizuku_status["Provider status model<br/>[ShizukuStatus.kt]"]
  node_shizuku_shell["Shell binder client<br/>[ShizukuShell.kt]"]
  node_shell_service["Privileged shell executor"]
end

subgraph group_settings["Preferences and Permissions"]
  node_settings_repo[("Settings persistence")]
  node_permission_manager["Runtime permissions"]
end

node_user(("Device user"))
node_android["Android system"]
node_shizuku_provider["Shizuku / Sui"]

node_user -.->|"opens and operates"| node_main
node_main -->|"hosts routes"| node_navigator
node_main -->|"shows navigation"| node_bottom_bar
node_bottom_bar -->|"selects presentation"| node_ui_mode
node_main -.->|"routes to"| node_home
node_main -.->|"routes to"| node_service_screen
node_main -.->|"provides settings page"| node_settings_screen
node_main -->|"routes to"| node_about_palette
node_service_screen -.->|"reads and changes services"| node_access_repo
node_access_repo -->|"returns service records"| node_service_meta
node_main -->|"reads enabled state"| node_access_repo
node_main -->|"publishes badge count"| node_enabled_counter
node_access_repo -->|"checks readiness"| node_shizuku_manager
node_access_repo -->|"executes secure-setting writes"| node_shizuku_shell
node_shizuku_manager -->|"publishes status"| node_shizuku_status
node_shizuku_manager -->|"checks binder and permission"| node_shizuku_provider
node_shizuku_shell -->|"binds user service"| node_shell_service
node_shell_service -->|"runs shell commands"| node_android
node_android -->|"provides installed services and state"| node_access_repo
node_settings_screen -.->|"reads and saves preferences"| node_settings_repo
node_settings_screen -.->|"manages requested permissions"| node_permission_manager
node_settings_repo -->|"persists UI choice"| node_ui_mode

click node_main "https://github.com/shimmerfly/accesshub/blob/AccessHub/app/src/main/java/dev/sol/accesshub/ui/MainActivity.kt"
click node_navigator "https://github.com/shimmerfly/accesshub/blob/AccessHub/app/src/main/java/dev/sol/accesshub/ui/navigation3/Navigator.kt"
click node_home "https://github.com/shimmerfly/accesshub/tree/AccessHub/app/src/main/java/dev/sol/accesshub/ui/screen/home"
click node_service_screen "https://github.com/shimmerfly/accesshub/tree/AccessHub/app/src/main/java/dev/sol/accesshub/ui/screen/accessibility"
click node_settings_screen "https://github.com/shimmerfly/accesshub/tree/AccessHub/app/src/main/java/dev/sol/accesshub/ui/screen/settings"
click node_about_palette "https://github.com/shimmerfly/accesshub/tree/AccessHub/app/src/main/java/dev/sol/accesshub/ui/screen"
click node_bottom_bar "https://github.com/shimmerfly/accesshub/blob/AccessHub/app/src/main/java/dev/sol/accesshub/ui/component/bottombar/BottomBar.kt"
click node_ui_mode "https://github.com/shimmerfly/accesshub/blob/AccessHub/app/src/main/java/dev/sol/accesshub/ui/UiMode.kt"
click node_access_repo "https://github.com/shimmerfly/accesshub/blob/AccessHub/app/src/main/java/dev/sol/accesshub/data/repository/AccessibilityRepository.kt"
click node_service_meta "https://github.com/shimmerfly/accesshub/blob/AccessHub/app/src/main/java/dev/sol/accesshub/data/ServiceMeta.kt"
click node_enabled_counter "https://github.com/shimmerfly/accesshub/blob/AccessHub/app/src/main/java/dev/sol/accesshub/data/repository/EnabledServicesCounter.kt"
click node_shizuku_manager "https://github.com/shimmerfly/accesshub/blob/AccessHub/app/src/main/java/dev/sol/accesshub/shizuku/ShizukuManager.kt"
click node_shizuku_status "https://github.com/shimmerfly/accesshub/blob/AccessHub/app/src/main/java/dev/sol/accesshub/shizuku/ShizukuStatus.kt"
click node_shizuku_shell "https://github.com/shimmerfly/accesshub/blob/AccessHub/app/src/main/java/dev/sol/accesshub/shizuku/ShizukuShell.kt"
click node_shell_service "https://github.com/shimmerfly/accesshub/blob/AccessHub/app/src/main/java/dev/sol/accesshub/shizuku/ShellUserService.kt"
click node_settings_repo "https://github.com/shimmerfly/accesshub/blob/AccessHub/app/src/main/java/dev/sol/accesshub/data/repository/SettingsRepositoryImpl.kt"
click node_permission_manager "https://github.com/shimmerfly/accesshub/blob/AccessHub/app/src/main/java/dev/sol/accesshub/permission/PermissionManager.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_navigator,node_home,node_service_screen,node_settings_screen,node_about_palette,node_bottom_bar,node_ui_mode,node_user,node_shizuku_provider toneBlue
class node_access_repo,node_service_meta,node_enabled_counter toneAmber
class node_shizuku_manager,node_shizuku_status,node_shizuku_shell,node_shell_service toneMint
class node_settings_repo,node_permission_manager toneRose
class node_android toneIndigo
```

## Components

### Application UI

- [Activity and navigation](https://github.com/shimmerfly/accesshub/blob/AccessHub/app/src/main/java/dev/sol/accesshub/ui/MainActivity.kt): `app/src/main/java/dev/sol/accesshub/ui/MainActivity.kt`
- [Route navigator](https://github.com/shimmerfly/accesshub/blob/AccessHub/app/src/main/java/dev/sol/accesshub/ui/navigation3/Navigator.kt): `app/src/main/java/dev/sol/accesshub/ui/navigation3/Navigator.kt`
- [Home screen](https://github.com/shimmerfly/accesshub/tree/AccessHub/app/src/main/java/dev/sol/accesshub/ui/screen/home): `app/src/main/java/dev/sol/accesshub/ui/screen/home`
- [Accessibility screen](https://github.com/shimmerfly/accesshub/tree/AccessHub/app/src/main/java/dev/sol/accesshub/ui/screen/accessibility): `app/src/main/java/dev/sol/accesshub/ui/screen/accessibility`
- [Settings screen](https://github.com/shimmerfly/accesshub/tree/AccessHub/app/src/main/java/dev/sol/accesshub/ui/screen/settings): `app/src/main/java/dev/sol/accesshub/ui/screen/settings`
- [About and palette](https://github.com/shimmerfly/accesshub/tree/AccessHub/app/src/main/java/dev/sol/accesshub/ui/screen): `app/src/main/java/dev/sol/accesshub/ui/screen`
- [Navigation bars](https://github.com/shimmerfly/accesshub/blob/AccessHub/app/src/main/java/dev/sol/accesshub/ui/component/bottombar/BottomBar.kt): `app/src/main/java/dev/sol/accesshub/ui/component/bottombar/BottomBar.kt`
- [UI mode](https://github.com/shimmerfly/accesshub/blob/AccessHub/app/src/main/java/dev/sol/accesshub/ui/UiMode.kt): `app/src/main/java/dev/sol/accesshub/ui/UiMode.kt`

### Accessibility Domain

- [Service repository](https://github.com/shimmerfly/accesshub/blob/AccessHub/app/src/main/java/dev/sol/accesshub/data/repository/AccessibilityRepository.kt): `app/src/main/java/dev/sol/accesshub/data/repository/AccessibilityRepository.kt`
- [Service metadata](https://github.com/shimmerfly/accesshub/blob/AccessHub/app/src/main/java/dev/sol/accesshub/data/ServiceMeta.kt): `app/src/main/java/dev/sol/accesshub/data/ServiceMeta.kt`
- [Enabled-service badge](https://github.com/shimmerfly/accesshub/blob/AccessHub/app/src/main/java/dev/sol/accesshub/data/repository/EnabledServicesCounter.kt): `app/src/main/java/dev/sol/accesshub/data/repository/EnabledServicesCounter.kt`

### Privilege Bridge

- [Provider status and permission](https://github.com/shimmerfly/accesshub/blob/AccessHub/app/src/main/java/dev/sol/accesshub/shizuku/ShizukuManager.kt): `app/src/main/java/dev/sol/accesshub/shizuku/ShizukuManager.kt`
- [Provider status model](https://github.com/shimmerfly/accesshub/blob/AccessHub/app/src/main/java/dev/sol/accesshub/shizuku/ShizukuStatus.kt): `app/src/main/java/dev/sol/accesshub/shizuku/ShizukuStatus.kt`
- [Shell binder client](https://github.com/shimmerfly/accesshub/blob/AccessHub/app/src/main/java/dev/sol/accesshub/shizuku/ShizukuShell.kt): `app/src/main/java/dev/sol/accesshub/shizuku/ShizukuShell.kt`
- [Privileged shell executor](https://github.com/shimmerfly/accesshub/blob/AccessHub/app/src/main/java/dev/sol/accesshub/shizuku/ShellUserService.kt): `app/src/main/java/dev/sol/accesshub/shizuku/ShellUserService.kt`

### Preferences and Permissions

- [Settings persistence](https://github.com/shimmerfly/accesshub/blob/AccessHub/app/src/main/java/dev/sol/accesshub/data/repository/SettingsRepositoryImpl.kt): `app/src/main/java/dev/sol/accesshub/data/repository/SettingsRepositoryImpl.kt`
- [Runtime permissions](https://github.com/shimmerfly/accesshub/blob/AccessHub/app/src/main/java/dev/sol/accesshub/permission/PermissionManager.kt): `app/src/main/java/dev/sol/accesshub/permission/PermissionManager.kt`

### Other components

- **Device user**
- **Android system**
- **Shizuku / Sui**

## Connections

- Device user → Activity and navigation: opens and operates
- Activity and navigation → Route navigator: hosts routes (evidence: `app/src/main/java/dev/sol/accesshub/ui/MainActivity.kt`)
- Activity and navigation → Navigation bars: shows navigation (evidence: `app/src/main/java/dev/sol/accesshub/ui/MainActivity.kt`)
- Navigation bars → UI mode: selects presentation (evidence: `app/src/main/java/dev/sol/accesshub/ui/component/bottombar/BottomBar.kt`)
- Activity and navigation → Home screen: routes to
- Activity and navigation → Accessibility screen: routes to
- Activity and navigation → Settings screen: provides settings page
- Activity and navigation → About and palette: routes to (evidence: `app/src/main/java/dev/sol/accesshub/ui/MainActivity.kt`)
- Accessibility screen → Service repository: reads and changes services
- Service repository → Service metadata: returns service records (evidence: `app/src/main/java/dev/sol/accesshub/data/repository/AccessibilityRepository.kt`)
- Activity and navigation → Service repository: reads enabled state (evidence: `app/src/main/java/dev/sol/accesshub/ui/MainActivity.kt`)
- Activity and navigation → Enabled-service badge: publishes badge count (evidence: `app/src/main/java/dev/sol/accesshub/ui/MainActivity.kt`)
- Service repository → Provider status and permission: checks readiness (evidence: `app/src/main/java/dev/sol/accesshub/data/repository/AccessibilityRepository.kt`)
- Service repository → Shell binder client: executes secure-setting writes (evidence: `app/src/main/java/dev/sol/accesshub/data/repository/AccessibilityRepository.kt`)
- Provider status and permission → Provider status model: publishes status (evidence: `app/src/main/java/dev/sol/accesshub/shizuku/ShizukuManager.kt`)
- Provider status and permission → Shizuku / Sui: checks binder and permission (evidence: `app/src/main/java/dev/sol/accesshub/shizuku/ShizukuManager.kt`)
- Shell binder client → Privileged shell executor: binds user service (evidence: `app/src/main/java/dev/sol/accesshub/shizuku/ShizukuShell.kt`)
- Privileged shell executor → Android system: runs shell commands (evidence: `app/src/main/java/dev/sol/accesshub/shizuku/ShellUserService.kt`)
- Android system → Service repository: provides installed services and state (evidence: `app/src/main/java/dev/sol/accesshub/data/repository/AccessibilityRepository.kt`)
- Settings screen → Settings persistence: reads and saves preferences
- Settings screen → Runtime permissions: manages requested permissions
- Settings persistence → UI mode: persists UI choice (evidence: `app/src/main/java/dev/sol/accesshub/data/repository/SettingsRepositoryImpl.kt`)
