How mikudayoooooooo/hypersidebar works
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: FanMenuController.kt Fan controller · ComposeFanHost.kt Fan presentation · ShortcutLauncher.kt Shortcut launcher · EdgeGestureHook.kt Edge gestures
Components 21
Gesture integration
- Edge gestures
app/src/main/java/com/lsp/hypersidebar/hook/EdgeGestureHook.kt - Landscape hooks
app/src/main/java/com/lsp/hypersidebar/hook/TurboLayout.kt - System UI hooks
app/src/main/java/com/lsp/hypersidebar/hook/SystemUiHook.kt
Fan experience
- Fan controller
app/src/main/java/com/lsp/hypersidebar/ui/fan/FanMenuController.kt - Fan presentation
app/src/main/java/com/lsp/hypersidebar/ui/fan/ComposeFanHost.kt - Fan geometry
app/src/main/java/com/lsp/hypersidebar/ui/fan/FanGeometry.kt - All apps
app/src/main/java/com/lsp/hypersidebar/ui/allapps/AllAppsActivity.kt - App suggestions
app/src/main/java/com/lsp/hypersidebar/util/DataLoader.kt - Background sampling
app/src/main/java/com/lsp/hypersidebar/util/WallpaperSampler.kt
Configuration
- Settings screens
app/src/main/java/com/lsp/hypersidebar/ui/settings/MainScreen.kt - Settings entry
app/src/main/java/com/lsp/hypersidebar/MainActivity.kt - Settings repository
app/src/main/java/com/lsp/hypersidebar/prefs/SettingsRepository.kt - Remote preferences
app/src/main/java/com/lsp/hypersidebar/util/RemotePrefsBridge.kt - Config sync
app/src/main/java/com/lsp/hypersidebar/util/ConfigSync.kt
Launch paths
- Shortcut launcher
app/src/main/java/com/lsp/hypersidebar/util/ShortcutLauncher.kt - Shortcut relay
app/src/main/java/com/lsp/hypersidebar/ShortcutRelayReceiver.kt - Freeform launch
app/src/main/java/com/lsp/hypersidebar/util/FreeformLauncher.kt
Diagnostics
- Usage statistics
app/src/main/java/com/lsp/hypersidebar/util/StatsRecorder.kt - Diagnostics and logs
app/src/main/java/com/lsp/hypersidebar/ui/settings/DiagnosticsPage.kt
Other components
- User
- HyperOS hosts
Connections 22
- User → Edge gestures: invokes gesture
- HyperOS hosts → Edge gestures: delivers touch
- Edge gestures → Fan controller: requests fan
app/src/main/java/com/lsp/hypersidebar/hook/EdgeGestureHook.kt - Landscape hooks → Fan controller: uses controller
app/src/main/java/com/lsp/hypersidebar/hook/TurboLayout.kt - Fan controller → Fan presentation: uses presentation
app/src/main/java/com/lsp/hypersidebar/ui/fan/FanMenuController.kt - Fan presentation → Fan geometry: uses geometry
app/src/main/java/com/lsp/hypersidebar/ui/fan/ComposeFanHost.kt - Fan controller → App suggestions: loads suggestions
app/src/main/java/com/lsp/hypersidebar/ui/fan/FanMenuController.kt - Fan controller → Shortcut launcher: launches shortcut
app/src/main/java/com/lsp/hypersidebar/ui/fan/FanMenuController.kt - Fan controller → Usage statistics: records usage
app/src/main/java/com/lsp/hypersidebar/ui/fan/FanMenuController.kt - Fan presentation → Background sampling: samples background
app/src/main/java/com/lsp/hypersidebar/ui/fan/ComposeFanHost.kt - User → Settings screens: configures
- Settings entry → Settings screens: opens screens
app/src/main/java/com/lsp/hypersidebar/MainActivity.kt - Settings screens → Settings repository: edits settings
app/src/main/java/com/lsp/hypersidebar/prefs/SettingsRepository.kt - Settings entry → Remote preferences: binds preferences
app/src/main/java/com/lsp/hypersidebar/MainActivity.kt - Settings repository → Config sync: syncs configuration
app/src/main/java/com/lsp/hypersidebar/prefs/SettingsRepository.kt - All apps → Remote preferences: reads preferences
app/src/main/java/com/lsp/hypersidebar/ui/allapps/AllAppsActivity.kt - Shortcut launcher → Freeform launch: uses freeform launch
app/src/main/java/com/lsp/hypersidebar/util/ShortcutLauncher.kt - Shortcut launcher → Shortcut relay: relays launch
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