# shashvat1965/slidesense architecture

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

- Interactive diagram: https://gitdiagram.com/shashvat1965/slidesense
- Repository: https://github.com/shashvat1965/slidesense

## Overview

SlideSense is a macOS menu-bar app that turns trackpad-edge gestures into system-level changes. The main workflow is touch frames → gesture interpretation → level/media actions → HUD and menu feedback. Settings control edge mapping, gesture behavior, appearance, startup, and updates. The coordinator is the internal layer connecting input, controllers, and UI. The README documents the major capabilities; some connections to unsampled implementation details are omitted rather than inferred.

Main entry points: [`Sources/SlideSenseCore/AppCoordinator.swift`](https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/AppCoordinator.swift) (App Coordinator), [`Sources/SlideSenseCore/UI/SettingsView.swift`](https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/UI/SettingsView.swift) (Settings View), [`Sources/SlideSenseCore/Multitouch/TrackpadMonitor.swift`](https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/Multitouch/TrackpadMonitor.swift) (Trackpad Monitor), [`Sources/SlideSenseCore/Model/SlideEngine.swift`](https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/Model/SlideEngine.swift) (Gesture Engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_input["Touch and Gestures"]
  node_trackpad["Trackpad Monitor"]
  node_touch["Touch Frames<br/>[TouchInput.swift]"]
  node_engine["Gesture Engine<br/>[SlideEngine.swift]"]
  node_geometry["Edge Geometry<br/>[EdgeGeometry.swift]"]
end

subgraph group_control["System Controls"]
  node_audio["Audio Controller"]
  node_brightness["Brightness Controller"]
  node_media["Media Key Controller"]
  node_levels["Level Protocol"]
  node_haptics["Haptics<br/>[Haptics.swift]"]
  node_cursor["Cursor Freeze"]
end

subgraph group_interface["App Interface"]
  node_coordinator["App Coordinator"]
  node_hud["HUD Controller"]
  node_hudview["HUD View<br/>[HUDView.swift]"]
  node_status["Menu Bar"]
  node_settingswindow["Settings Window"]
  node_settingsview["Settings View<br/>[SettingsView.swift]"]
  node_appdelegate["App Delegate<br/>[AppDelegate.swift]"]
  node_entry["App Entry<br/>[main.swift]"]
end

subgraph group_lifecycle["Settings and Lifecycle"]
  node_settings[("Settings Store<br/>[Settings.swift]")]
  node_permission["Accessibility Permission"]
  node_login["Login Item<br/>[LoginItem.swift]"]
  node_updater["Update Controller"]
end

node_user(("Trackpad User"))
node_os(("macOS Services"))
node_releases(("GitHub Releases"))

node_user -->|"makes gestures"| node_trackpad
node_trackpad -->|"emits frames"| node_touch
node_touch -->|"interpreted by"| node_engine
node_engine -->|"uses geometry"| node_geometry
node_coordinator -->|"starts monitoring"| node_trackpad
node_coordinator -->|"configures gestures"| node_engine
node_coordinator -->|"controls volume"| node_audio
node_coordinator -->|"controls brightness"| node_brightness
node_coordinator -->|"dispatches media"| node_media
node_coordinator -->|"triggers feedback"| node_haptics
node_coordinator -->|"freezes pointer"| node_cursor
node_audio -->|"reads and writes volume"| node_os
node_brightness -->|"sets brightness"| node_os
node_media -->|"posts key events"| node_os
node_coordinator -->|"presents feedback"| node_hud
node_hud -->|"configures view"| node_hudview
node_coordinator -->|"provides readouts"| node_status
node_coordinator -->|"opens settings"| node_settingswindow
node_settingswindow -->|"hosts view"| node_settingsview
node_settingsview -->|"edits settings"| node_settings
node_status -->|"reads enabled state"| node_settings
node_settingsview -->|"shows permission"| node_permission
node_settingsview -->|"configures startup"| node_login
node_coordinator -->|"checks access"| node_permission
node_coordinator -->|"manages startup"| node_login
node_coordinator -->|"checks releases"| node_updater
node_updater -->|"fetches updates"| node_releases
node_entry -->|"starts app"| node_appdelegate
node_appdelegate -->|"creates coordinator"| node_coordinator

click node_trackpad "https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/Multitouch/TrackpadMonitor.swift"
click node_touch "https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/Multitouch/TouchInput.swift"
click node_engine "https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/Model/SlideEngine.swift"
click node_geometry "https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/Model/EdgeGeometry.swift"
click node_coordinator "https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/AppCoordinator.swift"
click node_audio "https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/System/AudioController.swift"
click node_brightness "https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/System/BrightnessController.swift"
click node_media "https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/System/MediaKeyController.swift"
click node_levels "https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/System/LevelController.swift"
click node_haptics "https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/System/Haptics.swift"
click node_cursor "https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/System/CursorFreezer.swift"
click node_hud "https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/UI/HUDController.swift"
click node_hudview "https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/UI/HUDView.swift"
click node_status "https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/UI/StatusItemController.swift"
click node_settingswindow "https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/UI/SettingsWindowController.swift"
click node_settingsview "https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/UI/SettingsView.swift"
click node_settings "https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/Model/Settings.swift"
click node_permission "https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/System/AccessibilityPermission.swift"
click node_login "https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/System/LoginItem.swift"
click node_updater "https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/System/UpdateController.swift"
click node_appdelegate "https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/AppDelegate.swift"
click node_entry "https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSense/main.swift"

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_trackpad,node_touch,node_engine,node_geometry,node_user toneBlue
class node_audio,node_brightness,node_media,node_levels,node_haptics,node_cursor toneAmber
class node_coordinator,node_hud,node_hudview,node_status,node_settingswindow,node_settingsview,node_appdelegate,node_entry toneMint
class node_settings,node_permission,node_login,node_updater toneRose
class node_os,node_releases toneIndigo
```

## Components

### Touch and Gestures

- [Trackpad Monitor](https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/Multitouch/TrackpadMonitor.swift): `Sources/SlideSenseCore/Multitouch/TrackpadMonitor.swift`
- [Touch Frames](https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/Multitouch/TouchInput.swift): `Sources/SlideSenseCore/Multitouch/TouchInput.swift`
- [Gesture Engine](https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/Model/SlideEngine.swift): `Sources/SlideSenseCore/Model/SlideEngine.swift`
- [Edge Geometry](https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/Model/EdgeGeometry.swift): `Sources/SlideSenseCore/Model/EdgeGeometry.swift`

### System Controls

- [Audio Controller](https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/System/AudioController.swift): `Sources/SlideSenseCore/System/AudioController.swift`
- [Brightness Controller](https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/System/BrightnessController.swift): `Sources/SlideSenseCore/System/BrightnessController.swift`
- [Media Key Controller](https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/System/MediaKeyController.swift): `Sources/SlideSenseCore/System/MediaKeyController.swift`
- [Level Protocol](https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/System/LevelController.swift): `Sources/SlideSenseCore/System/LevelController.swift`
- [Haptics](https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/System/Haptics.swift): `Sources/SlideSenseCore/System/Haptics.swift`
- [Cursor Freeze](https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/System/CursorFreezer.swift): `Sources/SlideSenseCore/System/CursorFreezer.swift`

### App Interface

- [App Coordinator](https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/AppCoordinator.swift): `Sources/SlideSenseCore/AppCoordinator.swift`
- [HUD Controller](https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/UI/HUDController.swift): `Sources/SlideSenseCore/UI/HUDController.swift`
- [HUD View](https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/UI/HUDView.swift): `Sources/SlideSenseCore/UI/HUDView.swift`
- [Menu Bar](https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/UI/StatusItemController.swift): `Sources/SlideSenseCore/UI/StatusItemController.swift`
- [Settings Window](https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/UI/SettingsWindowController.swift): `Sources/SlideSenseCore/UI/SettingsWindowController.swift`
- [Settings View](https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/UI/SettingsView.swift): `Sources/SlideSenseCore/UI/SettingsView.swift`
- [App Delegate](https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/AppDelegate.swift): `Sources/SlideSenseCore/AppDelegate.swift`
- [App Entry](https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSense/main.swift): `Sources/SlideSense/main.swift`

### Settings and Lifecycle

- [Settings Store](https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/Model/Settings.swift): `Sources/SlideSenseCore/Model/Settings.swift`
- [Accessibility Permission](https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/System/AccessibilityPermission.swift): `Sources/SlideSenseCore/System/AccessibilityPermission.swift`
- [Login Item](https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/System/LoginItem.swift): `Sources/SlideSenseCore/System/LoginItem.swift`
- [Update Controller](https://github.com/shashvat1965/slidesense/blob/main/Sources/SlideSenseCore/System/UpdateController.swift): `Sources/SlideSenseCore/System/UpdateController.swift`

### Other components

- **Trackpad User**
- **macOS Services**
- **GitHub Releases**

## Connections

- Trackpad User → Trackpad Monitor: makes gestures (evidence: `README.md`)
- Trackpad Monitor → Touch Frames: emits frames (evidence: `README.md`)
- Touch Frames → Gesture Engine: interpreted by (evidence: `README.md`)
- Gesture Engine → Edge Geometry: uses geometry (evidence: `Sources/SlideSenseCore/Model/SlideEngine.swift`)
- App Coordinator → Trackpad Monitor: starts monitoring (evidence: `Sources/SlideSenseCore/AppCoordinator.swift`)
- App Coordinator → Gesture Engine: configures gestures (evidence: `Sources/SlideSenseCore/AppCoordinator.swift`)
- App Coordinator → Audio Controller: controls volume (evidence: `Sources/SlideSenseCore/AppCoordinator.swift`)
- App Coordinator → Brightness Controller: controls brightness (evidence: `Sources/SlideSenseCore/AppCoordinator.swift`)
- App Coordinator → Media Key Controller: dispatches media (evidence: `Sources/SlideSenseCore/AppCoordinator.swift`)
- App Coordinator → Haptics: triggers feedback (evidence: `Sources/SlideSenseCore/AppCoordinator.swift`)
- App Coordinator → Cursor Freeze: freezes pointer (evidence: `Sources/SlideSenseCore/AppCoordinator.swift`)
- Audio Controller → macOS Services: reads and writes volume (evidence: `README.md`)
- Brightness Controller → macOS Services: sets brightness (evidence: `README.md`)
- Media Key Controller → macOS Services: posts key events (evidence: `Sources/SlideSenseCore/System/MediaKeyController.swift`)
- App Coordinator → HUD Controller: presents feedback (evidence: `Sources/SlideSenseCore/AppCoordinator.swift`)
- HUD Controller → HUD View: configures view (evidence: `Sources/SlideSenseCore/UI/HUDController.swift`)
- App Coordinator → Menu Bar: provides readouts (evidence: `Sources/SlideSenseCore/AppCoordinator.swift`)
- App Coordinator → Settings Window: opens settings (evidence: `Sources/SlideSenseCore/AppCoordinator.swift`)
- Settings Window → Settings View: hosts view (evidence: `Sources/SlideSenseCore/UI/SettingsWindowController.swift`)
- Settings View → Settings Store: edits settings (evidence: `Sources/SlideSenseCore/UI/SettingsView.swift`)
- Menu Bar → Settings Store: reads enabled state (evidence: `Sources/SlideSenseCore/UI/StatusItemController.swift`)
- Settings View → Accessibility Permission: shows permission (evidence: `Sources/SlideSenseCore/UI/SettingsView.swift`)
- Settings View → Login Item: configures startup (evidence: `Sources/SlideSenseCore/UI/SettingsView.swift`)
- App Coordinator → Accessibility Permission: checks access (evidence: `Sources/SlideSenseCore/AppCoordinator.swift`)
- App Coordinator → Login Item: manages startup (evidence: `Sources/SlideSenseCore/AppCoordinator.swift`)
- App Coordinator → Update Controller: checks releases (evidence: `Sources/SlideSenseCore/AppCoordinator.swift`)
- Update Controller → GitHub Releases: fetches updates (evidence: `README.md`)
- App Entry → App Delegate: starts app (evidence: `Sources/SlideSense/main.swift`)
- App Delegate → App Coordinator: creates coordinator (evidence: `Sources/SlideSenseCore/AppDelegate.swift`)
