CalBridge

CalBridge is a native macOS menu bar calendar app built with SwiftUI + EventKit.

Features

• Menu bar date/time display with optional upcoming meeting preview.
• Month and week calendar views with event indicators.
• Event list grouped by day with quick navigation to today.
• Event detail panel with attendees, notes, meeting links, and open-in-Calendar actions.
• Quick add event parsing from natural text.
• Calendar filtering (select calendars to include).
• Global keyboard shortcuts (toggle popover, join upcoming meeting).
• Preferences window for display and behavior settings.

App Experience

Settings

Week View

Menu Bar Preview

Caveat

• Native accept/decline RSVP is not available via public EventKit APIs, so invite responses must be handled in Apple Calendar (opened from the app).

Tech Stack

• Swift 5.9
• SwiftUI (macOS app UI)
• EventKit (Apple Calendar integration)
• Combine (state updates)

Project Structure

• Sources/CalBridge/MacCalendarApp.swift — app entry point.
• Sources/CalBridge/Managers/ — menu bar, events, settings, hotkeys, parsing, windows.
• Sources/CalBridge/Views/ — calendar, settings, shortcut recorder, event detail UI.
• Sources/CalBridge/Utils/ — formatters, keyboard shortcut model, scroll helpers, EventKit extensions.
• project.yml — XcodeGen project definition.
• Package.swift — Swift Package definition.

Setup

Prerequisites

• macOS 14+
• Xcode 15+ (recommended)
• Swift 5.9+

Run in Xcode (recommended)

1. Open CalBridge.xcodeproj.
2. Select the app target and your signing team.
3. Build and run.

On first launch, macOS asks for Calendar permission. Grant access to load events.

Build from terminal

swift build

Run from terminal

swift run

Install

Option 1: Install from PKG release

1. Download CalBridge.pkg from the latest release/workflow artifact.
2. Run the installer package.
3. Launch CalBridge from Applications.

If macOS blocks launch (unsigned app):

1. Open System Settings → Privacy & Security.
2. Under Security, allow CalBridge/Open Anyway.
3. Launch again.

Option 2: Build and install locally

1. Open CalBridge.xcodeproj in Xcode.
2. Build the app (Product → Build).
3. Copy the generated .app to /Applications (or run directly from Xcode).