# jordanbaird/ice architecture

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

- Interactive diagram: https://gitdiagram.com/jordanbaird/ice
- Repository: https://github.com/jordanbaird/ice

## Overview

Ice is a macOS menu-bar management app. Users organize menu-bar items into visible, hidden, and always-hidden sections, then reveal or rehide them through menu-bar interactions, an optional Ice Bar, or hotkeys; they can also search items and customize layout and appearance. AppState coordinates the runtime managers, while settings expose configuration for these capabilities. The README documents the major features; some implementation paths are unsampled, so those branches are represented at directory level and their internal links are omitted where evidence is unavailable.

Main entry points: [`Ice/Main/AppState.swift`](https://github.com/jordanbaird/ice/blob/main/Ice/Main/AppState.swift) (App state), [`Ice/MenuBar/MenuBarItems/MenuBarItemManager.swift`](https://github.com/jordanbaird/ice/blob/main/Ice/MenuBar/MenuBarItems/MenuBarItemManager.swift) (Item manager), [`Ice/MenuBar/MenuBarSection.swift`](https://github.com/jordanbaird/ice/blob/main/Ice/MenuBar/MenuBarSection.swift) (Menu bar sections), [`Ice/MenuBar/MenuBarManager.swift`](https://github.com/jordanbaird/ice/blob/main/Ice/MenuBar/MenuBarManager.swift) (Menu bar manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["App runtime"]
  node_app["Ice app<br/>[IceApp.swift]"]
  node_state["App state<br/>[AppState.swift]"]
end

subgraph group_items["Item management"]
  node_itemmgr["Item manager"]
  node_item["Menu bar item<br/>[MenuBarItem.swift]"]
  node_iteminfo["Item metadata"]
  node_section["Menu bar sections"]
  node_control["Section controls<br/>[ControlItem.swift]"]
end

subgraph group_presentation["Menu bar presentation"]
  node_menubar["Menu bar manager"]
  node_icebar["Ice Bar<br/>[IceBar.swift]"]
  node_layout["Layout editor"]
  node_appearance["Appearance manager"]
  node_appearanceui["Appearance editor"]
  node_search["Item search"]
  node_spacing["Item spacing"]
end

subgraph group_interaction["Input and settings"]
  node_events["Event handling<br/>[EventManager.swift]"]
  node_hotkeys["Hotkey registry"]
  node_hotkeysettings["Hotkey settings"]
  node_settings["Settings<br/>[SettingsView.swift]"]
  node_generalsettings["General settings"]
end

subgraph group_services["System services"]
  node_permissions["Permissions"]
  node_updates["Automatic updates"]
  node_defaults[("Preferences store<br/>[Defaults.swift]")]
  node_bridging["macOS bridging<br/>[Bridging.swift]"]
end

node_user(("Mac user"))
node_macos["macOS window system"]

node_user -->|"uses"| node_app
node_app -.->|"creates"| node_state
node_state -->|"coordinates"| node_itemmgr
node_state -->|"coordinates"| node_menubar
node_state -->|"coordinates"| node_events
node_state -->|"coordinates"| node_appearance
node_state -->|"coordinates"| node_permissions
node_state -->|"coordinates"| node_updates
node_itemmgr -->|"manages"| node_item
node_itemmgr -->|"updates"| node_section
node_item -->|"builds from"| node_iteminfo
node_itemmgr -.->|"reads windows"| node_macos
node_events -->|"shows or hides"| node_section
node_section -->|"uses"| node_control
node_menubar -->|"manages"| node_section
node_menubar -->|"opens"| node_search
node_section -->|"shows"| node_icebar
node_user -->|"arranges items"| node_layout
node_state -->|"exposes state"| node_layout
node_user -->|"searches items"| node_search
node_user -->|"customizes"| node_appearanceui
node_appearance -->|"configures"| node_appearanceui
node_user -->|"invokes actions"| node_hotkeys
node_hotkeys -.->|"toggles sections"| node_section
node_settings -.->|"edits preferences"| node_generalsettings
node_settings -.->|"edits hotkeys"| node_hotkeysettings
node_generalsettings -->|"persists values"| node_defaults
node_appearance -->|"loads configuration"| node_defaults
node_state -->|"coordinates"| node_settings
node_state -->|"coordinates"| node_hotkeys
node_itemmgr -->|"posts events"| node_bridging
node_itemmgr -.->|"adjusts spacing"| node_spacing
node_user -->|"configures spacing"| node_spacing

click node_app "https://github.com/jordanbaird/ice/blob/main/Ice/Main/IceApp.swift"
click node_state "https://github.com/jordanbaird/ice/blob/main/Ice/Main/AppState.swift"
click node_events "https://github.com/jordanbaird/ice/blob/main/Ice/Events/EventManager.swift"
click node_itemmgr "https://github.com/jordanbaird/ice/blob/main/Ice/MenuBar/MenuBarItems/MenuBarItemManager.swift"
click node_item "https://github.com/jordanbaird/ice/blob/main/Ice/MenuBar/MenuBarItems/MenuBarItem.swift"
click node_iteminfo "https://github.com/jordanbaird/ice/blob/main/Ice/MenuBar/MenuBarItems/MenuBarItemInfo.swift"
click node_section "https://github.com/jordanbaird/ice/blob/main/Ice/MenuBar/MenuBarSection.swift"
click node_control "https://github.com/jordanbaird/ice/blob/main/Ice/MenuBar/ControlItem/ControlItem.swift"
click node_menubar "https://github.com/jordanbaird/ice/blob/main/Ice/MenuBar/MenuBarManager.swift"
click node_icebar "https://github.com/jordanbaird/ice/blob/main/Ice/UI/IceBar/IceBar.swift"
click node_layout "https://github.com/jordanbaird/ice/blob/main/Ice/UI/LayoutBar/LayoutBarContainer.swift"
click node_appearance "https://github.com/jordanbaird/ice/blob/main/Ice/MenuBar/Appearance/MenuBarAppearanceManager.swift"
click node_appearanceui "https://github.com/jordanbaird/ice/blob/main/Ice/MenuBar/Appearance/MenuBarAppearanceEditor/MenuBarAppearanceEditor.swift"
click node_search "https://github.com/jordanbaird/ice/blob/main/Ice/MenuBar/Search/MenuBarSearchPanel.swift"
click node_spacing "https://github.com/jordanbaird/ice/blob/main/Ice/MenuBar/Spacing/MenuBarItemSpacingManager.swift"
click node_hotkeys "https://github.com/jordanbaird/ice/blob/main/Ice/Hotkeys/HotkeyRegistry.swift"
click node_hotkeysettings "https://github.com/jordanbaird/ice/blob/main/Ice/Settings/SettingsManagers/HotkeySettingsManager.swift"
click node_settings "https://github.com/jordanbaird/ice/blob/main/Ice/Settings/SettingsView.swift"
click node_generalsettings "https://github.com/jordanbaird/ice/blob/main/Ice/Settings/SettingsManagers/GeneralSettingsManager.swift"
click node_permissions "https://github.com/jordanbaird/ice/blob/main/Ice/Permissions/PermissionsManager.swift"
click node_updates "https://github.com/jordanbaird/ice/blob/main/Ice/Updates/UpdatesManager.swift"
click node_defaults "https://github.com/jordanbaird/ice/blob/main/Ice/Utilities/Defaults.swift"
click node_bridging "https://github.com/jordanbaird/ice/blob/main/Ice/Bridging/Bridging.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_app,node_state,node_user toneBlue
class node_itemmgr,node_item,node_iteminfo,node_section,node_control toneAmber
class node_menubar,node_icebar,node_layout,node_appearance,node_appearanceui,node_search,node_spacing toneMint
class node_events,node_hotkeys,node_hotkeysettings,node_settings,node_generalsettings toneRose
class node_permissions,node_updates,node_defaults,node_bridging,node_macos toneIndigo
```

## Components

### App runtime

- [Ice app](https://github.com/jordanbaird/ice/blob/main/Ice/Main/IceApp.swift): `Ice/Main/IceApp.swift`
- [App state](https://github.com/jordanbaird/ice/blob/main/Ice/Main/AppState.swift): `Ice/Main/AppState.swift`

### Item management

- [Item manager](https://github.com/jordanbaird/ice/blob/main/Ice/MenuBar/MenuBarItems/MenuBarItemManager.swift): `Ice/MenuBar/MenuBarItems/MenuBarItemManager.swift`
- [Menu bar item](https://github.com/jordanbaird/ice/blob/main/Ice/MenuBar/MenuBarItems/MenuBarItem.swift): `Ice/MenuBar/MenuBarItems/MenuBarItem.swift`
- [Item metadata](https://github.com/jordanbaird/ice/blob/main/Ice/MenuBar/MenuBarItems/MenuBarItemInfo.swift): `Ice/MenuBar/MenuBarItems/MenuBarItemInfo.swift`
- [Menu bar sections](https://github.com/jordanbaird/ice/blob/main/Ice/MenuBar/MenuBarSection.swift): `Ice/MenuBar/MenuBarSection.swift`
- [Section controls](https://github.com/jordanbaird/ice/blob/main/Ice/MenuBar/ControlItem/ControlItem.swift): `Ice/MenuBar/ControlItem/ControlItem.swift`

### Menu bar presentation

- [Menu bar manager](https://github.com/jordanbaird/ice/blob/main/Ice/MenuBar/MenuBarManager.swift): `Ice/MenuBar/MenuBarManager.swift`
- [Ice Bar](https://github.com/jordanbaird/ice/blob/main/Ice/UI/IceBar/IceBar.swift): `Ice/UI/IceBar/IceBar.swift`
- [Layout editor](https://github.com/jordanbaird/ice/blob/main/Ice/UI/LayoutBar/LayoutBarContainer.swift): `Ice/UI/LayoutBar/LayoutBarContainer.swift`
- [Appearance manager](https://github.com/jordanbaird/ice/blob/main/Ice/MenuBar/Appearance/MenuBarAppearanceManager.swift): `Ice/MenuBar/Appearance/MenuBarAppearanceManager.swift`
- [Appearance editor](https://github.com/jordanbaird/ice/blob/main/Ice/MenuBar/Appearance/MenuBarAppearanceEditor/MenuBarAppearanceEditor.swift): `Ice/MenuBar/Appearance/MenuBarAppearanceEditor/MenuBarAppearanceEditor.swift`
- [Item search](https://github.com/jordanbaird/ice/blob/main/Ice/MenuBar/Search/MenuBarSearchPanel.swift): `Ice/MenuBar/Search/MenuBarSearchPanel.swift`
- [Item spacing](https://github.com/jordanbaird/ice/blob/main/Ice/MenuBar/Spacing/MenuBarItemSpacingManager.swift): `Ice/MenuBar/Spacing/MenuBarItemSpacingManager.swift`

### Input and settings

- [Event handling](https://github.com/jordanbaird/ice/blob/main/Ice/Events/EventManager.swift): `Ice/Events/EventManager.swift`
- [Hotkey registry](https://github.com/jordanbaird/ice/blob/main/Ice/Hotkeys/HotkeyRegistry.swift): `Ice/Hotkeys/HotkeyRegistry.swift`
- [Hotkey settings](https://github.com/jordanbaird/ice/blob/main/Ice/Settings/SettingsManagers/HotkeySettingsManager.swift): `Ice/Settings/SettingsManagers/HotkeySettingsManager.swift`
- [Settings](https://github.com/jordanbaird/ice/blob/main/Ice/Settings/SettingsView.swift): `Ice/Settings/SettingsView.swift`
- [General settings](https://github.com/jordanbaird/ice/blob/main/Ice/Settings/SettingsManagers/GeneralSettingsManager.swift): `Ice/Settings/SettingsManagers/GeneralSettingsManager.swift`

### System services

- [Permissions](https://github.com/jordanbaird/ice/blob/main/Ice/Permissions/PermissionsManager.swift): `Ice/Permissions/PermissionsManager.swift`
- [Automatic updates](https://github.com/jordanbaird/ice/blob/main/Ice/Updates/UpdatesManager.swift): `Ice/Updates/UpdatesManager.swift`
- [Preferences store](https://github.com/jordanbaird/ice/blob/main/Ice/Utilities/Defaults.swift): `Ice/Utilities/Defaults.swift`
- [macOS bridging](https://github.com/jordanbaird/ice/blob/main/Ice/Bridging/Bridging.swift): `Ice/Bridging/Bridging.swift`

### Other components

- **Mac user**
- **macOS window system**

## Connections

- Mac user → Ice app: uses (evidence: `README.md`)
- Ice app → App state: creates
- App state → Item manager: coordinates (evidence: `Ice/Main/AppState.swift`)
- App state → Menu bar manager: coordinates (evidence: `Ice/Main/AppState.swift`)
- App state → Event handling: coordinates (evidence: `Ice/Main/AppState.swift`)
- App state → Appearance manager: coordinates (evidence: `Ice/Main/AppState.swift`)
- App state → Permissions: coordinates (evidence: `Ice/Main/AppState.swift`)
- App state → Automatic updates: coordinates (evidence: `Ice/Main/AppState.swift`)
- Item manager → Menu bar item: manages (evidence: `Ice/MenuBar/MenuBarItems/MenuBarItemManager.swift`)
- Item manager → Menu bar sections: updates (evidence: `Ice/MenuBar/MenuBarItems/MenuBarItemManager.swift`)
- Menu bar item → Item metadata: builds from (evidence: `Ice/MenuBar/MenuBarItems/MenuBarItem.swift`)
- Item manager → macOS window system: reads windows
- Event handling → Menu bar sections: shows or hides (evidence: `Ice/Events/EventManager.swift`)
- Menu bar sections → Section controls: uses (evidence: `Ice/MenuBar/MenuBarSection.swift`)
- Menu bar manager → Menu bar sections: manages (evidence: `Ice/MenuBar/MenuBarManager.swift`)
- Menu bar manager → Item search: opens (evidence: `Ice/MenuBar/MenuBarManager.swift`)
- Menu bar sections → Ice Bar: shows (evidence: `Ice/MenuBar/MenuBarSection.swift`)
- Mac user → Layout editor: arranges items (evidence: `README.md`)
- App state → Layout editor: exposes state (evidence: `Ice/UI/LayoutBar/LayoutBarContainer.swift`)
- Mac user → Item search: searches items (evidence: `README.md`)
- Mac user → Appearance editor: customizes (evidence: `README.md`)
- Appearance manager → Appearance editor: configures
- Mac user → Hotkey registry: invokes actions (evidence: `README.md`)
- Hotkey registry → Menu bar sections: toggles sections
- Settings → General settings: edits preferences
- Settings → Hotkey settings: edits hotkeys
- General settings → Preferences store: persists values (evidence: `Ice/Settings/SettingsManagers/GeneralSettingsManager.swift`)
- Appearance manager → Preferences store: loads configuration (evidence: `Ice/MenuBar/Appearance/MenuBarAppearanceManager.swift`)
- App state → Settings: coordinates (evidence: `Ice/Main/AppState.swift`)
- App state → Hotkey registry: coordinates (evidence: `Ice/Main/AppState.swift`)
- Item manager → macOS bridging: posts events (evidence: `Ice/MenuBar/MenuBarItems/MenuBarItemManager.swift`)
- Item manager → Item spacing: adjusts spacing
- Mac user → Item spacing: configures spacing (evidence: `README.md`)
