Pangea 🦖

A native macOS menu-bar app for sticky notes and whiteboards — with optional AI (chat & research over your notes), a Miro export, embedded Google Docs, and fully separated profiles.

Features

Notes

• Menu-bar app with a Dock icon; the notes themselves are the app
• Sticky notes with rich text (bold/italic/underline), colors, groups, pinning, tags (#tag), and clickable to-do checkboxes with a progress badge
• Overview board to browse, search and edit all notes in one window
• Global hotkeys for a new note, full-text search, the overview, the chat and research
• Auto-lists (bullet/numbered) and a Markdown preview

Whiteboards

• Freeform diagram notes: rectangles, ellipses, text tiles, connectors (arrows, dashed, curved), images (drag-in or ⌘V paste), frames (titled containers), groups
• Smart alignment guides, snapping, marquee/⌘-click multi-select, mouse-wheel zoom & pan
• Dynamically growing canvas that expands in every direction as you move content out
• Embedded Google Docs/Sheets (live preview) via Google OAuth

AI (optional, via OpenRouter)

• RAG chat grounded in your notes (local embeddings + vector search)
• Per-note / per-whiteboard research assistant (streaming, tool calling, image/PDF attachments) that knows the note's or diagram's content
• Everything is gated by a master switch — with AI off, no note content ever leaves the device

Integrations

• Miro export: turn a whiteboard into real, editable Miro items (shapes, texts, connectors, images, frames, groups) via OAuth
• Google Drive: embed and read Docs/Sheets

Profiles

• Multiple isolated profiles (e.g. Work / Private) with separate notes/whiteboards, AI settings and integrations. Switching relaunches the app.

Requirements

• macOS 26+ (Tahoe) — required for the SwiftData/SwiftUI features used
• Xcode 26+
• XcodeGen (brew install xcodegen)

No external Swift dependencies — the app uses only Apple frameworks.

Build & run

./scripts/build.sh          # generates the project and builds it
open build/Build/Products/Debug/Pangea.app

scripts/dmg.sh builds a Release and packs it into a distributable, ad-hoc-signed .dmg.

Note (Nix/devenv): If a Nix devenv is active in your shell, it overrides DEVELOPER_DIR, SDKROOT, LD etc. and hijacks Xcode's linker. scripts/build.sh/scripts/dmg.sh strip these variables before invoking xcodebuild. A direct xcodebuild fails with ld: unknown options in such a shell.

Configuration

AI and integrations are optional and off until configured (Settings → Integrations / AI):

• AI: an OpenRouter API key, stored in the Keychain.
• Miro: a Miro developer app (redirect URI http://localhost:51703/callback, scopes boards:read/boards:write).
• Google: a Google Cloud OAuth client of type Desktop app with the Drive API enabled.

Secrets and OAuth tokens are always stored in the macOS Keychain, never in plain text.

Project structure

Pangea/
├── App/         entry point, window manager, menu bar, main menu
├── Models/      Note, NoteGroup (SwiftData) + Diagram
├── Services/    AI (OpenRouter, embeddings, chat, assistant), Miro/Google, profiles
├── Support/     Keychain, diagram geometry/text, image & web helpers
├── Views/       SwiftUI views (note, whiteboard, settings, overview, chat…)
└── Windows/     AppKit window controllers
PangeaTests/     unit tests (pure logic: diagram, mapping, parsing…)
scripts/         build.sh, dmg.sh

Icons

The app and menu-bar icons show a T-Rex logo. The source SVGs (logo.svg, logo-mono.svg, logo-contour.svg) are rasterized into the assets under Pangea/Assets.xcassets/ (the app icon in color, the menu-bar icon as a monochrome template).

Known limitations / roadmap

• No app signing/notarization (dev build, ad-hoc signed)
• German UI localization is being reintroduced via the String Catalog

Contributing

Contributions are welcome! Please read CONTRIBUTING.md and the Code of Conduct first.

Important: By opening a pull request you agree to the Contributor License Agreement. It keeps your contributions under the GPLv3 and grants the project maintainer the right to also distribute the code under other licenses (see License).

License

Pangea is licensed under the GNU General Public License v3.0 — see LICENSE. This means anyone who distributes the app or builds on it must also release their version's source under the GPLv3. Pangea therefore stays open source permanently.

Dual licensing

The maintainer (Jan Gehring) is the sole copyright holder (secured via the CLA) and additionally offers Pangea under a commercial license. This specifically allows:

• distributing signed binaries via the Mac App Store (whose DRM/terms are incompatible with the GPL), and
• developing proprietary (closed-source) extensions.

As the copyright holder, the maintainer is not bound by their own GPLv3. For third parties only the GPLv3 applies, unless a separate commercial license has been obtained. For commercial licensing inquiries: jan.gehring@gmail.com.

Pangea uses no third-party libraries; it builds only against Apple's SDK frameworks.