How jordanbaird/ice works
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: AppState.swift App state · MenuBarItemManager.swift Item manager · MenuBarSection.swift Menu bar sections · MenuBarManager.swift Menu bar manager
Components 25
Item management
- Item manager
Ice/MenuBar/MenuBarItems/MenuBarItemManager.swift - Menu bar item
Ice/MenuBar/MenuBarItems/MenuBarItem.swift - Item metadata
Ice/MenuBar/MenuBarItems/MenuBarItemInfo.swift - Menu bar sections
Ice/MenuBar/MenuBarSection.swift - Section controls
Ice/MenuBar/ControlItem/ControlItem.swift
Menu bar presentation
- Menu bar manager
Ice/MenuBar/MenuBarManager.swift - Ice Bar
Ice/UI/IceBar/IceBar.swift - Layout editor
Ice/UI/LayoutBar/LayoutBarContainer.swift - Appearance manager
Ice/MenuBar/Appearance/MenuBarAppearanceManager.swift - Appearance editor
Ice/MenuBar/Appearance/MenuBarAppearanceEditor/MenuBarAppearanceEditor.swift - Item search
Ice/MenuBar/Search/MenuBarSearchPanel.swift - Item spacing
Ice/MenuBar/Spacing/MenuBarItemSpacingManager.swift
Input and settings
- Event handling
Ice/Events/EventManager.swift - Hotkey registry
Ice/Hotkeys/HotkeyRegistry.swift - Hotkey settings
Ice/Settings/SettingsManagers/HotkeySettingsManager.swift - Settings
Ice/Settings/SettingsView.swift - General settings
Ice/Settings/SettingsManagers/GeneralSettingsManager.swift
System services
- Permissions
Ice/Permissions/PermissionsManager.swift - Automatic updates
Ice/Updates/UpdatesManager.swift - Preferences store
Ice/Utilities/Defaults.swift - macOS bridging
Ice/Bridging/Bridging.swift
Other components
- Mac user
- macOS window system
Connections 33
- Mac user → Ice app: uses
README.md - Ice app → App state: creates
- App state → Item manager: coordinates
Ice/Main/AppState.swift - App state → Menu bar manager: coordinates
Ice/Main/AppState.swift - App state → Event handling: coordinates
Ice/Main/AppState.swift - App state → Appearance manager: coordinates
Ice/Main/AppState.swift - App state → Permissions: coordinates
Ice/Main/AppState.swift - App state → Automatic updates: coordinates
Ice/Main/AppState.swift - Item manager → Menu bar item: manages
Ice/MenuBar/MenuBarItems/MenuBarItemManager.swift - Item manager → Menu bar sections: updates
Ice/MenuBar/MenuBarItems/MenuBarItemManager.swift - Menu bar item → Item metadata: builds from
Ice/MenuBar/MenuBarItems/MenuBarItem.swift - Item manager → macOS window system: reads windows
- Event handling → Menu bar sections: shows or hides
Ice/Events/EventManager.swift - Menu bar sections → Section controls: uses
Ice/MenuBar/MenuBarSection.swift - Menu bar manager → Menu bar sections: manages
Ice/MenuBar/MenuBarManager.swift - Menu bar manager → Item search: opens
Ice/MenuBar/MenuBarManager.swift - Menu bar sections → Ice Bar: shows
Ice/MenuBar/MenuBarSection.swift - Mac user → Layout editor: arranges items
README.md - App state → Layout editor: exposes state
Ice/UI/LayoutBar/LayoutBarContainer.swift - Mac user → Item search: searches items
README.md - Mac user → Appearance editor: customizes
README.md - Appearance manager → Appearance editor: configures
- Mac user → Hotkey registry: invokes actions
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
Ice/Settings/SettingsManagers/GeneralSettingsManager.swift - Appearance manager → Preferences store: loads configuration
Ice/MenuBar/Appearance/MenuBarAppearanceManager.swift - App state → Settings: coordinates
Ice/Main/AppState.swift - App state → Hotkey registry: coordinates
Ice/Main/AppState.swift - Item manager → macOS bridging: posts events
Ice/MenuBar/MenuBarItems/MenuBarItemManager.swift - Item manager → Item spacing: adjusts spacing
- Mac user → Item spacing: configures spacing
README.md