# skyrilhd/hotapps architecture

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

- Interactive diagram: https://gitdiagram.com/skyrilhd/hotapps
- Repository: https://github.com/skyrilhd/hotapps

## Overview

HotApps is a macOS menu-bar utility that opens a configured application when the pointer reaches an enabled screen corner, and can hide the frontmost app when that corner is assigned to it. The main workflow runs from mouse-movement monitoring through corner detection and delayed validation to application activation or hiding. Settings configure corner assignments and behavior, persisted through UserDefaults; the status-bar menu exposes settings, About, and quit actions. A separate login-item launcher starts the main app when configured. Source excerpts show the principal runtime wiring; the README documents the corner-trigger behavior.

Main entry points: [`HotApps/AppDelegate.swift`](https://github.com/skyrilhd/hotapps/blob/main/HotApps/AppDelegate.swift) (App lifecycle), [`HotApps/Settings.swift`](https://github.com/skyrilhd/hotapps/blob/main/HotApps/Settings.swift) (Settings window), [`HotApps/StatusBar.swift`](https://github.com/skyrilhd/hotapps/blob/main/HotApps/StatusBar.swift) (Status menu), [`HotApps/main.swift`](https://github.com/skyrilhd/hotapps/blob/main/HotApps/main.swift) (App entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Corner runtime"]
  node_main["App entry<br/>[main.swift]"]
  node_delegate["App lifecycle<br/>[AppDelegate.swift]"]
  node_corner["Corner detection<br/>[AppDelegate.swift]"]
  node_activation["App activation<br/>[AppDelegate.swift]"]
end

subgraph group_interface["User interface"]
  node_settings["Settings window<br/>[Settings.swift]"]
  node_preferences[("Saved preferences<br/>[Settings.swift]")]
  node_status["Status menu<br/>[StatusBar.swift]"]
  node_about["About window<br/>[AboutApp.swift]"]
end

subgraph group_startup["Launch support"]
  node_launcher["Login launcher<br/>[main.swift]"]
end

node_user(("User"))
node_mouse(("Mouse movement"))
node_macos["macOS services"]

node_user -->|"starts app"| node_main
node_main -->|"sets delegate"| node_delegate
node_delegate -->|"monitors mouse"| node_macos
node_mouse -->|"triggers checks"| node_corner
node_delegate -->|"checks pointer"| node_corner
node_corner -->|"dispatches corner"| node_activation
node_activation -->|"opens or hides"| node_macos
node_delegate -->|"reads settings"| node_preferences
node_delegate -->|"creates menu"| node_status
node_status -->|"routes menu actions"| node_delegate
node_delegate -->|"opens window"| node_settings
node_delegate -->|"opens window"| node_about
node_settings -->|"reads and writes"| node_preferences
node_settings -->|"updates menu"| node_status
node_settings -->|"updates startup"| node_delegate
node_delegate -->|"enables login item"| node_launcher
node_launcher -->|"checks and launches"| node_macos

click node_main "https://github.com/skyrilhd/hotapps/blob/main/HotApps/main.swift"
click node_delegate "https://github.com/skyrilhd/hotapps/blob/main/HotApps/AppDelegate.swift"
click node_corner "https://github.com/skyrilhd/hotapps/blob/main/HotApps/AppDelegate.swift"
click node_activation "https://github.com/skyrilhd/hotapps/blob/main/HotApps/AppDelegate.swift"
click node_settings "https://github.com/skyrilhd/hotapps/blob/main/HotApps/Settings.swift"
click node_preferences "https://github.com/skyrilhd/hotapps/blob/main/HotApps/Settings.swift"
click node_status "https://github.com/skyrilhd/hotapps/blob/main/HotApps/StatusBar.swift"
click node_about "https://github.com/skyrilhd/hotapps/blob/main/HotApps/AboutApp.swift"
click node_launcher "https://github.com/skyrilhd/hotapps/blob/main/HotAppsLauncher/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_main,node_delegate,node_corner,node_activation,node_user toneBlue
class node_settings,node_preferences,node_status,node_about toneAmber
class node_launcher toneMint
class node_mouse,node_macos toneIndigo
```

## Components

### Corner runtime

- [App entry](https://github.com/skyrilhd/hotapps/blob/main/HotApps/main.swift): `HotApps/main.swift`
- [App lifecycle](https://github.com/skyrilhd/hotapps/blob/main/HotApps/AppDelegate.swift): `HotApps/AppDelegate.swift`
- [Corner detection](https://github.com/skyrilhd/hotapps/blob/main/HotApps/AppDelegate.swift): `HotApps/AppDelegate.swift`
- [App activation](https://github.com/skyrilhd/hotapps/blob/main/HotApps/AppDelegate.swift): `HotApps/AppDelegate.swift`

### User interface

- [Settings window](https://github.com/skyrilhd/hotapps/blob/main/HotApps/Settings.swift): `HotApps/Settings.swift`
- [Saved preferences](https://github.com/skyrilhd/hotapps/blob/main/HotApps/Settings.swift): `HotApps/Settings.swift`
- [Status menu](https://github.com/skyrilhd/hotapps/blob/main/HotApps/StatusBar.swift): `HotApps/StatusBar.swift`
- [About window](https://github.com/skyrilhd/hotapps/blob/main/HotApps/AboutApp.swift): `HotApps/AboutApp.swift`

### Launch support

- [Login launcher](https://github.com/skyrilhd/hotapps/blob/main/HotAppsLauncher/main.swift): `HotAppsLauncher/main.swift`

### Other components

- **User**
- **Mouse movement**
- **macOS services**

## Connections

- User → App entry: starts app (evidence: `README.md`)
- App entry → App lifecycle: sets delegate (evidence: `HotApps/main.swift`)
- App lifecycle → macOS services: monitors mouse (evidence: `HotApps/AppDelegate.swift`)
- Mouse movement → Corner detection: triggers checks (evidence: `HotApps/AppDelegate.swift`)
- App lifecycle → Corner detection: checks pointer (evidence: `HotApps/AppDelegate.swift`)
- Corner detection → App activation: dispatches corner (evidence: `HotApps/AppDelegate.swift`)
- App activation → macOS services: opens or hides (evidence: `HotApps/AppDelegate.swift`)
- App lifecycle → Saved preferences: reads settings (evidence: `HotApps/AppDelegate.swift`)
- App lifecycle → Status menu: creates menu (evidence: `HotApps/AppDelegate.swift`)
- Status menu → App lifecycle: routes menu actions (evidence: `HotApps/StatusBar.swift`)
- App lifecycle → Settings window: opens window (evidence: `HotApps/AppDelegate.swift`)
- App lifecycle → About window: opens window (evidence: `HotApps/AppDelegate.swift`)
- Settings window → Saved preferences: reads and writes (evidence: `HotApps/Settings.swift`)
- Settings window → Status menu: updates menu (evidence: `HotApps/Settings.swift`)
- Settings window → App lifecycle: updates startup (evidence: `HotApps/Settings.swift`)
- App lifecycle → Login launcher: enables login item (evidence: `HotApps/AppDelegate.swift`)
- Login launcher → macOS services: checks and launches (evidence: `HotAppsLauncher/main.swift`)
