# mikudayoooooooo/hypersidebar architecture

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

- Interactive diagram: https://gitdiagram.com/mikudayoooooooo/hypersidebar
- Repository: https://github.com/mikudayoooooooo/hypersidebar

## Overview

HyperSideBar replaces HyperOS’s native sidebar with a gesture-triggered, two-layer fan menu. The principal flow is a system-edge gesture, fan presentation and app selection, then freeform launch; settings configure its layout, apps, and shortcuts, while diagnostics expose logs and usage statistics. The README documents capabilities whose implementation details were not sampled. Edges based on source-index references show module relationships, not necessarily call direction, so those are dashed and marked unverified.

Main entry points: [`app/src/main/java/com/lsp/hypersidebar/ui/fan/FanMenuController.kt`](https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/ui/fan/FanMenuController.kt) (Fan controller), [`app/src/main/java/com/lsp/hypersidebar/ui/fan/ComposeFanHost.kt`](https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/ui/fan/ComposeFanHost.kt) (Fan presentation), [`app/src/main/java/com/lsp/hypersidebar/util/ShortcutLauncher.kt`](https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/util/ShortcutLauncher.kt) (Shortcut launcher), [`app/src/main/java/com/lsp/hypersidebar/hook/EdgeGestureHook.kt`](https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/hook/EdgeGestureHook.kt) (Edge gestures)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_gesture["Gesture integration"]
  node_edgehook["Edge gestures<br/>[EdgeGestureHook.kt]"]
  node_turbo["Landscape hooks<br/>[TurboLayout.kt]"]
  node_systemui["System UI hooks<br/>[SystemUiHook.kt]"]
end

subgraph group_fan["Fan experience"]
  node_fancontroller["Fan controller"]
  node_fanhost["Fan presentation<br/>[ComposeFanHost.kt]"]
  node_geometry["Fan geometry<br/>[FanGeometry.kt]"]
  node_allapps["All apps<br/>[AllAppsActivity.kt]"]
  node_dataloader["App suggestions<br/>[DataLoader.kt]"]
  node_wallpaper["Background sampling"]
end

subgraph group_configuration["Configuration"]
  node_settingsui["Settings screens<br/>[MainScreen.kt]"]
  node_mainactivity["Settings entry<br/>[MainActivity.kt]"]
  node_settingsrepo[("Settings repository")]
  node_remoteprefs["Remote preferences"]
  node_configsync["Config sync<br/>[ConfigSync.kt]"]
end

subgraph group_launch["Launch paths"]
  node_shortcutlaunch["Shortcut launcher"]
  node_relay["Shortcut relay"]
  node_freeform["Freeform launch"]
end

subgraph group_diagnostics["Diagnostics"]
  node_stats[("Usage statistics<br/>[StatsRecorder.kt]")]
  node_diagnostics["Diagnostics and logs<br/>[DiagnosticsPage.kt]"]
end

node_user(("User"))
node_hyperos["HyperOS hosts"]

node_user -->|"invokes gesture"| node_edgehook
node_hyperos -.->|"delivers touch"| node_edgehook
node_edgehook -.->|"requests fan"| node_fancontroller
node_turbo -.->|"uses controller"| node_fancontroller
node_fancontroller -.->|"uses presentation"| node_fanhost
node_fanhost -.->|"uses geometry"| node_geometry
node_fancontroller -.->|"loads suggestions"| node_dataloader
node_fancontroller -.->|"launches shortcut"| node_shortcutlaunch
node_fancontroller -.->|"records usage"| node_stats
node_fanhost -.->|"samples background"| node_wallpaper
node_user -->|"configures"| node_settingsui
node_mainactivity -->|"opens screens"| node_settingsui
node_settingsui -.->|"edits settings"| node_settingsrepo
node_mainactivity -->|"binds preferences"| node_remoteprefs
node_settingsrepo -.->|"syncs configuration"| node_configsync
node_allapps -.->|"reads preferences"| node_remoteprefs
node_shortcutlaunch -.->|"uses freeform launch"| node_freeform
node_shortcutlaunch -.->|"relays launch"| node_relay
node_user -->|"browses apps"| node_allapps
node_user -->|"views diagnostics"| node_diagnostics
node_diagnostics -->|"reports usage"| node_stats
node_systemui -.->|"hooks system UI"| node_hyperos

click node_edgehook "https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/hook/EdgeGestureHook.kt"
click node_turbo "https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/hook/TurboLayout.kt"
click node_systemui "https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/hook/SystemUiHook.kt"
click node_fancontroller "https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/ui/fan/FanMenuController.kt"
click node_fanhost "https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/ui/fan/ComposeFanHost.kt"
click node_geometry "https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/ui/fan/FanGeometry.kt"
click node_allapps "https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/ui/allapps/AllAppsActivity.kt"
click node_settingsui "https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/ui/settings/MainScreen.kt"
click node_mainactivity "https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/MainActivity.kt"
click node_settingsrepo "https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/prefs/SettingsRepository.kt"
click node_remoteprefs "https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/util/RemotePrefsBridge.kt"
click node_configsync "https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/util/ConfigSync.kt"
click node_dataloader "https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/util/DataLoader.kt"
click node_shortcutlaunch "https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/util/ShortcutLauncher.kt"
click node_relay "https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/ShortcutRelayReceiver.kt"
click node_freeform "https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/util/FreeformLauncher.kt"
click node_stats "https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/util/StatsRecorder.kt"
click node_diagnostics "https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/ui/settings/DiagnosticsPage.kt"
click node_wallpaper "https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/util/WallpaperSampler.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_edgehook,node_turbo,node_systemui,node_user toneBlue
class node_fancontroller,node_fanhost,node_geometry,node_allapps,node_dataloader,node_wallpaper toneAmber
class node_settingsui,node_mainactivity,node_settingsrepo,node_remoteprefs,node_configsync toneMint
class node_shortcutlaunch,node_relay,node_freeform toneRose
class node_stats,node_diagnostics,node_hyperos toneIndigo
```

## Components

### Gesture integration

- [Edge gestures](https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/hook/EdgeGestureHook.kt): `app/src/main/java/com/lsp/hypersidebar/hook/EdgeGestureHook.kt`
- [Landscape hooks](https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/hook/TurboLayout.kt): `app/src/main/java/com/lsp/hypersidebar/hook/TurboLayout.kt`
- [System UI hooks](https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/hook/SystemUiHook.kt): `app/src/main/java/com/lsp/hypersidebar/hook/SystemUiHook.kt`

### Fan experience

- [Fan controller](https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/ui/fan/FanMenuController.kt): `app/src/main/java/com/lsp/hypersidebar/ui/fan/FanMenuController.kt`
- [Fan presentation](https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/ui/fan/ComposeFanHost.kt): `app/src/main/java/com/lsp/hypersidebar/ui/fan/ComposeFanHost.kt`
- [Fan geometry](https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/ui/fan/FanGeometry.kt): `app/src/main/java/com/lsp/hypersidebar/ui/fan/FanGeometry.kt`
- [All apps](https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/ui/allapps/AllAppsActivity.kt): `app/src/main/java/com/lsp/hypersidebar/ui/allapps/AllAppsActivity.kt`
- [App suggestions](https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/util/DataLoader.kt): `app/src/main/java/com/lsp/hypersidebar/util/DataLoader.kt`
- [Background sampling](https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/util/WallpaperSampler.kt): `app/src/main/java/com/lsp/hypersidebar/util/WallpaperSampler.kt`

### Configuration

- [Settings screens](https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/ui/settings/MainScreen.kt): `app/src/main/java/com/lsp/hypersidebar/ui/settings/MainScreen.kt`
- [Settings entry](https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/MainActivity.kt): `app/src/main/java/com/lsp/hypersidebar/MainActivity.kt`
- [Settings repository](https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/prefs/SettingsRepository.kt): `app/src/main/java/com/lsp/hypersidebar/prefs/SettingsRepository.kt`
- [Remote preferences](https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/util/RemotePrefsBridge.kt): `app/src/main/java/com/lsp/hypersidebar/util/RemotePrefsBridge.kt`
- [Config sync](https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/util/ConfigSync.kt): `app/src/main/java/com/lsp/hypersidebar/util/ConfigSync.kt`

### Launch paths

- [Shortcut launcher](https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/util/ShortcutLauncher.kt): `app/src/main/java/com/lsp/hypersidebar/util/ShortcutLauncher.kt`
- [Shortcut relay](https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/ShortcutRelayReceiver.kt): `app/src/main/java/com/lsp/hypersidebar/ShortcutRelayReceiver.kt`
- [Freeform launch](https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/util/FreeformLauncher.kt): `app/src/main/java/com/lsp/hypersidebar/util/FreeformLauncher.kt`

### Diagnostics

- [Usage statistics](https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/util/StatsRecorder.kt): `app/src/main/java/com/lsp/hypersidebar/util/StatsRecorder.kt`
- [Diagnostics and logs](https://github.com/mikudayoooooooo/hypersidebar/blob/master/app/src/main/java/com/lsp/hypersidebar/ui/settings/DiagnosticsPage.kt): `app/src/main/java/com/lsp/hypersidebar/ui/settings/DiagnosticsPage.kt`

### Other components

- **User**
- **HyperOS hosts**

## Connections

- User → Edge gestures: invokes gesture
- HyperOS hosts → Edge gestures: delivers touch
- Edge gestures → Fan controller: requests fan (evidence: `app/src/main/java/com/lsp/hypersidebar/hook/EdgeGestureHook.kt`)
- Landscape hooks → Fan controller: uses controller (evidence: `app/src/main/java/com/lsp/hypersidebar/hook/TurboLayout.kt`)
- Fan controller → Fan presentation: uses presentation (evidence: `app/src/main/java/com/lsp/hypersidebar/ui/fan/FanMenuController.kt`)
- Fan presentation → Fan geometry: uses geometry (evidence: `app/src/main/java/com/lsp/hypersidebar/ui/fan/ComposeFanHost.kt`)
- Fan controller → App suggestions: loads suggestions (evidence: `app/src/main/java/com/lsp/hypersidebar/ui/fan/FanMenuController.kt`)
- Fan controller → Shortcut launcher: launches shortcut (evidence: `app/src/main/java/com/lsp/hypersidebar/ui/fan/FanMenuController.kt`)
- Fan controller → Usage statistics: records usage (evidence: `app/src/main/java/com/lsp/hypersidebar/ui/fan/FanMenuController.kt`)
- Fan presentation → Background sampling: samples background (evidence: `app/src/main/java/com/lsp/hypersidebar/ui/fan/ComposeFanHost.kt`)
- User → Settings screens: configures
- Settings entry → Settings screens: opens screens (evidence: `app/src/main/java/com/lsp/hypersidebar/MainActivity.kt`)
- Settings screens → Settings repository: edits settings (evidence: `app/src/main/java/com/lsp/hypersidebar/prefs/SettingsRepository.kt`)
- Settings entry → Remote preferences: binds preferences (evidence: `app/src/main/java/com/lsp/hypersidebar/MainActivity.kt`)
- Settings repository → Config sync: syncs configuration (evidence: `app/src/main/java/com/lsp/hypersidebar/prefs/SettingsRepository.kt`)
- All apps → Remote preferences: reads preferences (evidence: `app/src/main/java/com/lsp/hypersidebar/ui/allapps/AllAppsActivity.kt`)
- Shortcut launcher → Freeform launch: uses freeform launch (evidence: `app/src/main/java/com/lsp/hypersidebar/util/ShortcutLauncher.kt`)
- Shortcut launcher → Shortcut relay: relays launch (evidence: `app/src/main/java/com/lsp/hypersidebar/util/ShortcutLauncher.kt`)
- User → All apps: browses apps
- User → Diagnostics and logs: views diagnostics
- Diagnostics and logs → Usage statistics: reports usage
- System UI hooks → HyperOS hosts: hooks system UI
