# nostrapollo/next-meeting-menu-bar architecture

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

- Interactive diagram: https://gitdiagram.com/nostrapollo/next-meeting-menu-bar
- Repository: https://github.com/nostrapollo/next-meeting-menu-bar

## Overview

NextMeeting is a local macOS menu-bar meeting countdown and one-step join app. Its main workflow reads permitted calendar events, filters and orders them, extracts supported conferencing links, and presents the next/current meeting; the global shortcut joins it by opening its URL. Calendar refresh and alert timing are coordinated by the calendar service, while settings configure calendars, timing, alerts, and the shortcut. The graph captures documented capabilities and sampled calls; some alert-window internals were not excerpted, so their implementation details are omitted.

Main entry points: [`NextMeeting/NextMeeting/NextMeetingApp.swift`](https://github.com/nostrapollo/next-meeting-menu-bar/blob/main/NextMeeting/NextMeeting/NextMeetingApp.swift) (App coordinator), [`NextMeeting/NextMeeting/Services/CalendarService.swift`](https://github.com/nostrapollo/next-meeting-menu-bar/blob/main/NextMeeting/NextMeeting/Services/CalendarService.swift) (Calendar service), [`NextMeeting/NextMeeting/Views/SettingsView.swift`](https://github.com/nostrapollo/next-meeting-menu-bar/blob/main/NextMeeting/NextMeeting/Views/SettingsView.swift) (Settings controls), [`NextMeeting/NextMeeting/Views/MenuContentView.swift`](https://github.com/nostrapollo/next-meeting-menu-bar/blob/main/NextMeeting/NextMeeting/Views/MenuContentView.swift) (Menu countdown)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App coordination"]
  node_app["App coordinator"]
end

subgraph group_calendar["Meeting pipeline"]
  node_calendar["Calendar service"]
  node_meeting["Meeting model<br/>[Meeting.swift]"]
  node_url["URL extraction"]
  node_alertpolicy["Alert timing"]
end

subgraph group_ui["User interface"]
  node_menu["Menu countdown"]
  node_alertwindow["Full-screen alert"]
  node_settingscontroller["Settings window"]
  node_settings["Settings controls<br/>[SettingsView.swift]"]
end

subgraph group_services["Preferences and integrations"]
  node_preferences["Preferences service"]
  node_shortcut["Global shortcut"]
  node_login["Launch at login"]
  node_defaults[("UserDefaults")]
end

node_user(("User"))
node_eventkit[("macOS calendars")]
node_workspace["macOS URL opener"]

node_user -->|"views meetings"| node_menu
node_app -->|"creates"| node_preferences
node_app -->|"creates"| node_calendar
node_app -->|"registers"| node_shortcut
node_app -->|"creates"| node_login
node_app -->|"shows"| node_menu
node_eventkit -->|"provides events"| node_calendar
node_calendar -->|"reads settings"| node_preferences
node_calendar -->|"fetches events"| node_eventkit
node_calendar -->|"builds meetings"| node_meeting
node_calendar -->|"extracts links"| node_url
node_calendar -->|"checks alert timing"| node_alertpolicy
node_menu -->|"displays meetings"| node_calendar
node_menu -->|"opens settings"| node_settingscontroller
node_settingscontroller -->|"creates view"| node_settings
node_settings -->|"edits options"| node_preferences
node_settings -->|"loads calendars"| node_calendar
node_settings -->|"configures shortcut"| node_shortcut
node_preferences -->|"persists options"| node_defaults
node_app -->|"shows alert"| node_alertwindow
node_shortcut -->|"triggers join"| node_app
node_app -->|"selects meeting"| node_calendar
node_app -->|"opens meeting link"| node_workspace
node_app -.->|"enables login start"| node_login
node_user -->|"presses shortcut"| node_shortcut

click node_app "https://github.com/nostrapollo/next-meeting-menu-bar/blob/main/NextMeeting/NextMeeting/NextMeetingApp.swift"
click node_calendar "https://github.com/nostrapollo/next-meeting-menu-bar/blob/main/NextMeeting/NextMeeting/Services/CalendarService.swift"
click node_meeting "https://github.com/nostrapollo/next-meeting-menu-bar/blob/main/NextMeeting/NextMeeting/Models/Meeting.swift"
click node_url "https://github.com/nostrapollo/next-meeting-menu-bar/blob/main/NextMeeting/NextMeeting/Services/MeetingURLExtractor.swift"
click node_alertpolicy "https://github.com/nostrapollo/next-meeting-menu-bar/blob/main/NextMeeting/NextMeeting/Services/MeetingAlertPolicy.swift"
click node_menu "https://github.com/nostrapollo/next-meeting-menu-bar/blob/main/NextMeeting/NextMeeting/Views/MenuContentView.swift"
click node_alertwindow "https://github.com/nostrapollo/next-meeting-menu-bar/blob/main/NextMeeting/NextMeeting/Views/MeetingAlertWindow.swift"
click node_settingscontroller "https://github.com/nostrapollo/next-meeting-menu-bar/blob/main/NextMeeting/NextMeeting/Views/SettingsWindowController.swift"
click node_settings "https://github.com/nostrapollo/next-meeting-menu-bar/blob/main/NextMeeting/NextMeeting/Views/SettingsView.swift"
click node_preferences "https://github.com/nostrapollo/next-meeting-menu-bar/blob/main/NextMeeting/NextMeeting/Services/PreferencesService.swift"
click node_shortcut "https://github.com/nostrapollo/next-meeting-menu-bar/blob/main/NextMeeting/NextMeeting/Services/KeyboardShortcutService.swift"
click node_login "https://github.com/nostrapollo/next-meeting-menu-bar/blob/main/NextMeeting/NextMeeting/Services/LaunchAtLoginService.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_user toneBlue
class node_calendar,node_meeting,node_url,node_alertpolicy,node_eventkit toneAmber
class node_menu,node_alertwindow,node_settingscontroller,node_settings toneMint
class node_preferences,node_shortcut,node_login,node_defaults toneRose
class node_workspace toneIndigo
```

## Components

### App coordination

- [App coordinator](https://github.com/nostrapollo/next-meeting-menu-bar/blob/main/NextMeeting/NextMeeting/NextMeetingApp.swift): `NextMeeting/NextMeeting/NextMeetingApp.swift`

### Meeting pipeline

- [Calendar service](https://github.com/nostrapollo/next-meeting-menu-bar/blob/main/NextMeeting/NextMeeting/Services/CalendarService.swift): `NextMeeting/NextMeeting/Services/CalendarService.swift`
- [Meeting model](https://github.com/nostrapollo/next-meeting-menu-bar/blob/main/NextMeeting/NextMeeting/Models/Meeting.swift): `NextMeeting/NextMeeting/Models/Meeting.swift`
- [URL extraction](https://github.com/nostrapollo/next-meeting-menu-bar/blob/main/NextMeeting/NextMeeting/Services/MeetingURLExtractor.swift): `NextMeeting/NextMeeting/Services/MeetingURLExtractor.swift`
- [Alert timing](https://github.com/nostrapollo/next-meeting-menu-bar/blob/main/NextMeeting/NextMeeting/Services/MeetingAlertPolicy.swift): `NextMeeting/NextMeeting/Services/MeetingAlertPolicy.swift`

### User interface

- [Menu countdown](https://github.com/nostrapollo/next-meeting-menu-bar/blob/main/NextMeeting/NextMeeting/Views/MenuContentView.swift): `NextMeeting/NextMeeting/Views/MenuContentView.swift`
- [Full-screen alert](https://github.com/nostrapollo/next-meeting-menu-bar/blob/main/NextMeeting/NextMeeting/Views/MeetingAlertWindow.swift): `NextMeeting/NextMeeting/Views/MeetingAlertWindow.swift`
- [Settings window](https://github.com/nostrapollo/next-meeting-menu-bar/blob/main/NextMeeting/NextMeeting/Views/SettingsWindowController.swift): `NextMeeting/NextMeeting/Views/SettingsWindowController.swift`
- [Settings controls](https://github.com/nostrapollo/next-meeting-menu-bar/blob/main/NextMeeting/NextMeeting/Views/SettingsView.swift): `NextMeeting/NextMeeting/Views/SettingsView.swift`

### Preferences and integrations

- [Preferences service](https://github.com/nostrapollo/next-meeting-menu-bar/blob/main/NextMeeting/NextMeeting/Services/PreferencesService.swift): `NextMeeting/NextMeeting/Services/PreferencesService.swift`
- [Global shortcut](https://github.com/nostrapollo/next-meeting-menu-bar/blob/main/NextMeeting/NextMeeting/Services/KeyboardShortcutService.swift): `NextMeeting/NextMeeting/Services/KeyboardShortcutService.swift`
- [Launch at login](https://github.com/nostrapollo/next-meeting-menu-bar/blob/main/NextMeeting/NextMeeting/Services/LaunchAtLoginService.swift): `NextMeeting/NextMeeting/Services/LaunchAtLoginService.swift`
- **UserDefaults**

### Other components

- **User**
- **macOS calendars**
- **macOS URL opener**

## Connections

- User → Menu countdown: views meetings (evidence: `README.md`)
- App coordinator → Preferences service: creates (evidence: `NextMeeting/NextMeeting/NextMeetingApp.swift`)
- App coordinator → Calendar service: creates (evidence: `NextMeeting/NextMeeting/NextMeetingApp.swift`)
- App coordinator → Global shortcut: registers (evidence: `NextMeeting/NextMeeting/NextMeetingApp.swift`)
- App coordinator → Launch at login: creates (evidence: `NextMeeting/NextMeeting/NextMeetingApp.swift`)
- App coordinator → Menu countdown: shows (evidence: `NextMeeting/NextMeeting/NextMeetingApp.swift`)
- macOS calendars → Calendar service: provides events (evidence: `README.md`)
- Calendar service → Preferences service: reads settings (evidence: `NextMeeting/NextMeeting/Services/CalendarService.swift`)
- Calendar service → macOS calendars: fetches events (evidence: `NextMeeting/NextMeeting/Services/CalendarService.swift`)
- Calendar service → Meeting model: builds meetings (evidence: `NextMeeting/NextMeeting/Services/CalendarService.swift`)
- Calendar service → URL extraction: extracts links (evidence: `NextMeeting/NextMeeting/Services/CalendarService.swift`)
- Calendar service → Alert timing: checks alert timing (evidence: `NextMeeting/NextMeeting/Services/CalendarService.swift`)
- Menu countdown → Calendar service: displays meetings (evidence: `NextMeeting/NextMeeting/Views/MenuContentView.swift`)
- Menu countdown → Settings window: opens settings (evidence: `NextMeeting/NextMeeting/Views/MenuContentView.swift`)
- Settings window → Settings controls: creates view (evidence: `NextMeeting/NextMeeting/Views/SettingsWindowController.swift`)
- Settings controls → Preferences service: edits options (evidence: `NextMeeting/NextMeeting/Views/SettingsView.swift`)
- Settings controls → Calendar service: loads calendars (evidence: `NextMeeting/NextMeeting/Views/SettingsView.swift`)
- Settings controls → Global shortcut: configures shortcut (evidence: `NextMeeting/NextMeeting/Views/SettingsView.swift`)
- Preferences service → UserDefaults: persists options (evidence: `NextMeeting/NextMeeting/Services/PreferencesService.swift`)
- App coordinator → Full-screen alert: shows alert (evidence: `NextMeeting/NextMeeting/NextMeetingApp.swift`)
- Global shortcut → App coordinator: triggers join (evidence: `NextMeeting/NextMeeting/NextMeetingApp.swift`)
- App coordinator → Calendar service: selects meeting (evidence: `NextMeeting/NextMeeting/NextMeetingApp.swift`)
- App coordinator → macOS URL opener: opens meeting link (evidence: `NextMeeting/NextMeeting/NextMeetingApp.swift`)
- App coordinator → Launch at login: enables login start (evidence: `README.md`)
- User → Global shortcut: presses shortcut (evidence: `README.md`)
