# nickustinov/itsypad-macos architecture

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

- Interactive diagram: https://gitdiagram.com/nickustinov/itsypad-macos
- Repository: https://github.com/nickustinov/itsypad-macos

## Overview

Itsypad is a macOS scratchpad/editor and clipboard-history app. The user-facing path starts at the app window or global hotkey, then opens editor tabs or clipboard history; editor work includes file browsing, search, preview and persisted sessions, while clipboard entries can be searched, previewed and copied. CloudKit sync is a separate optional capability for tabs and clipboard text. The index and excerpts establish only selected call relationships; unsampled feature links are left out rather than inferred.

Main entry points: [`Sources/App/AppDelegate.swift`](https://github.com/nickustinov/itsypad-macos/blob/main/Sources/App/AppDelegate.swift) (App lifecycle), [`Sources/Editor/EditorCoordinator.swift`](https://github.com/nickustinov/itsypad-macos/blob/main/Sources/Editor/EditorCoordinator.swift) (Editor coordinator), [`Sources/App/CloudSyncEngine.swift`](https://github.com/nickustinov/itsypad-macos/blob/main/Sources/App/CloudSyncEngine.swift) (Cloud sync), [`Sources/Settings/SettingsStore.swift`](https://github.com/nickustinov/itsypad-macos/blob/main/Sources/Settings/SettingsStore.swift) (Settings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App shell"]
  node_delegate["App lifecycle<br/>[AppDelegate.swift]"]
  node_root["Root window"]
  node_hotkeys["Global hotkeys"]
  node_menu["Menu commands<br/>[MenuBuilder.swift]"]
end

subgraph group_editor["Editor workspace"]
  node_tabs[("Tab persistence<br/>[TabStore.swift]")]
  node_editorcoord["Editor coordinator"]
  node_textview["Text editor"]
  node_syntax["Syntax highlighting"]
  node_markdown["Markdown preview"]
  node_session["Session restoration"]
  node_searchcontroller["Search overlay"]
  node_searchlogic["Search matching<br/>[GlobalSearch.swift]"]
  node_filebrowser["File browser"]
  node_filetree[("File tree")]
end

subgraph group_clip["Clipboard history"]
  node_clipview["Clipboard interface"]
  node_clipstore[("Clipboard history")]
  node_clippreview["Entry preview"]
end

subgraph group_split["Split layout"]
  node_bonsplitcontroller["Split controller"]
  node_splitlogic["Split state"]
  node_tabitem["Tab model<br/>[TabItem.swift]"]
end

subgraph group_support["Supporting services"]
  node_settings[("Settings")]
  node_cloud["Cloud sync"]
end

node_user(("Mac user"))
node_cloudkit["CloudKit"]

node_user -->|"launches"| node_delegate
node_delegate -->|"creates window"| node_root
node_delegate -->|"routes commands"| node_editorcoord
node_delegate -->|"registers"| node_hotkeys
node_hotkeys -->|"reads shortcuts"| node_settings
node_delegate -->|"builds menus"| node_menu
node_editorcoord -->|"coordinates"| node_textview
node_editorcoord -->|"persists tabs"| node_tabs
node_editorcoord -->|"updates previews"| node_markdown
node_markdown -->|"notifies changes"| node_editorcoord
node_searchcontroller -->|"searches text"| node_searchlogic
node_user -.->|"requests search"| node_searchcontroller
node_filebrowser -->|"restores folder"| node_filetree
node_user -.->|"opens files"| node_filebrowser
node_clipview -->|"reads history"| node_clipstore
node_clipview -.->|"shows preview"| node_clippreview
node_clippreview -->|"reads entry"| node_clipstore
node_clipview -->|"reads preferences"| node_settings
node_delegate -->|"configures history"| node_clipstore
node_root -.->|"hosts tabs"| node_bonsplitcontroller
node_bonsplitcontroller -.->|"manages layout"| node_splitlogic
node_splitlogic -->|"mutates tabs"| node_tabitem
node_session -->|"restores sessions"| node_tabs
node_session -->|"restores layout"| node_bonsplitcontroller
node_settings -->|"starts sync"| node_cloud
node_cloud -->|"syncs tab data"| node_tabs
node_cloud -->|"syncs clipboard text"| node_clipstore
node_cloud -->|"synchronizes records"| node_cloudkit
node_settings -.->|"selects theme"| node_syntax

click node_delegate "https://github.com/nickustinov/itsypad-macos/blob/main/Sources/App/AppDelegate.swift"
click node_root "https://github.com/nickustinov/itsypad-macos/blob/main/Sources/App/BonsplitRootView.swift"
click node_hotkeys "https://github.com/nickustinov/itsypad-macos/blob/main/Sources/Hotkey/HotkeyManager.swift"
click node_menu "https://github.com/nickustinov/itsypad-macos/blob/main/Sources/App/MenuBuilder.swift"
click node_tabs "https://github.com/nickustinov/itsypad-macos/blob/main/Sources/App/TabStore.swift"
click node_editorcoord "https://github.com/nickustinov/itsypad-macos/blob/main/Sources/Editor/EditorCoordinator.swift"
click node_textview "https://github.com/nickustinov/itsypad-macos/blob/main/Sources/Editor/EditorTextView.swift"
click node_syntax "https://github.com/nickustinov/itsypad-macos/blob/main/Sources/Editor/SyntaxHighlightCoordinator.swift"
click node_markdown "https://github.com/nickustinov/itsypad-macos/blob/main/Sources/Editor/MarkdownPreviewManager.swift"
click node_session "https://github.com/nickustinov/itsypad-macos/blob/main/Sources/Editor/SessionRestorer.swift"
click node_searchcontroller "https://github.com/nickustinov/itsypad-macos/blob/main/Sources/Search/GlobalSearchController.swift"
click node_searchlogic "https://github.com/nickustinov/itsypad-macos/blob/main/Sources/Search/GlobalSearch.swift"
click node_filebrowser "https://github.com/nickustinov/itsypad-macos/blob/main/Sources/FileBrowser/FileBrowserSplitViewController.swift"
click node_filetree "https://github.com/nickustinov/itsypad-macos/blob/main/Sources/FileBrowser/FileTreeStore.swift"
click node_clipview "https://github.com/nickustinov/itsypad-macos/blob/main/Sources/Clipboard/ClipboardContentView.swift"
click node_clipstore "https://github.com/nickustinov/itsypad-macos/blob/main/Sources/Clipboard/ClipboardStore.swift"
click node_clippreview "https://github.com/nickustinov/itsypad-macos/blob/main/Sources/Clipboard/ClipboardPreviewOverlay.swift"
click node_bonsplitcontroller "https://github.com/nickustinov/itsypad-macos/blob/main/Packages/Bonsplit/Sources/Bonsplit/Public/BonsplitController.swift"
click node_splitlogic "https://github.com/nickustinov/itsypad-macos/blob/main/Packages/Bonsplit/Sources/Bonsplit/Internal/Controllers/SplitViewController.swift"
click node_tabitem "https://github.com/nickustinov/itsypad-macos/blob/main/Packages/Bonsplit/Sources/Bonsplit/Internal/Models/TabItem.swift"
click node_settings "https://github.com/nickustinov/itsypad-macos/blob/main/Sources/Settings/SettingsStore.swift"
click node_cloud "https://github.com/nickustinov/itsypad-macos/blob/main/Sources/App/CloudSyncEngine.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_delegate,node_root,node_hotkeys,node_menu,node_user toneBlue
class node_tabs,node_editorcoord,node_textview,node_syntax,node_markdown,node_session,node_searchcontroller,node_searchlogic,node_filebrowser,node_filetree toneAmber
class node_clipview,node_clipstore,node_clippreview toneMint
class node_bonsplitcontroller,node_splitlogic,node_tabitem toneRose
class node_settings,node_cloud,node_cloudkit toneIndigo
```

## Components

### App shell

- [App lifecycle](https://github.com/nickustinov/itsypad-macos/blob/main/Sources/App/AppDelegate.swift): `Sources/App/AppDelegate.swift`
- [Root window](https://github.com/nickustinov/itsypad-macos/blob/main/Sources/App/BonsplitRootView.swift): `Sources/App/BonsplitRootView.swift`
- [Global hotkeys](https://github.com/nickustinov/itsypad-macos/blob/main/Sources/Hotkey/HotkeyManager.swift): `Sources/Hotkey/HotkeyManager.swift`
- [Menu commands](https://github.com/nickustinov/itsypad-macos/blob/main/Sources/App/MenuBuilder.swift): `Sources/App/MenuBuilder.swift`

### Editor workspace

- [Tab persistence](https://github.com/nickustinov/itsypad-macos/blob/main/Sources/App/TabStore.swift): `Sources/App/TabStore.swift`
- [Editor coordinator](https://github.com/nickustinov/itsypad-macos/blob/main/Sources/Editor/EditorCoordinator.swift): `Sources/Editor/EditorCoordinator.swift`
- [Text editor](https://github.com/nickustinov/itsypad-macos/blob/main/Sources/Editor/EditorTextView.swift): `Sources/Editor/EditorTextView.swift`
- [Syntax highlighting](https://github.com/nickustinov/itsypad-macos/blob/main/Sources/Editor/SyntaxHighlightCoordinator.swift): `Sources/Editor/SyntaxHighlightCoordinator.swift`
- [Markdown preview](https://github.com/nickustinov/itsypad-macos/blob/main/Sources/Editor/MarkdownPreviewManager.swift): `Sources/Editor/MarkdownPreviewManager.swift`
- [Session restoration](https://github.com/nickustinov/itsypad-macos/blob/main/Sources/Editor/SessionRestorer.swift): `Sources/Editor/SessionRestorer.swift`
- [Search overlay](https://github.com/nickustinov/itsypad-macos/blob/main/Sources/Search/GlobalSearchController.swift): `Sources/Search/GlobalSearchController.swift`
- [Search matching](https://github.com/nickustinov/itsypad-macos/blob/main/Sources/Search/GlobalSearch.swift): `Sources/Search/GlobalSearch.swift`
- [File browser](https://github.com/nickustinov/itsypad-macos/blob/main/Sources/FileBrowser/FileBrowserSplitViewController.swift): `Sources/FileBrowser/FileBrowserSplitViewController.swift`
- [File tree](https://github.com/nickustinov/itsypad-macos/blob/main/Sources/FileBrowser/FileTreeStore.swift): `Sources/FileBrowser/FileTreeStore.swift`

### Clipboard history

- [Clipboard interface](https://github.com/nickustinov/itsypad-macos/blob/main/Sources/Clipboard/ClipboardContentView.swift): `Sources/Clipboard/ClipboardContentView.swift`
- [Clipboard history](https://github.com/nickustinov/itsypad-macos/blob/main/Sources/Clipboard/ClipboardStore.swift): `Sources/Clipboard/ClipboardStore.swift`
- [Entry preview](https://github.com/nickustinov/itsypad-macos/blob/main/Sources/Clipboard/ClipboardPreviewOverlay.swift): `Sources/Clipboard/ClipboardPreviewOverlay.swift`

### Split layout

- [Split controller](https://github.com/nickustinov/itsypad-macos/blob/main/Packages/Bonsplit/Sources/Bonsplit/Public/BonsplitController.swift): `Packages/Bonsplit/Sources/Bonsplit/Public/BonsplitController.swift`
- [Split state](https://github.com/nickustinov/itsypad-macos/blob/main/Packages/Bonsplit/Sources/Bonsplit/Internal/Controllers/SplitViewController.swift): `Packages/Bonsplit/Sources/Bonsplit/Internal/Controllers/SplitViewController.swift`
- [Tab model](https://github.com/nickustinov/itsypad-macos/blob/main/Packages/Bonsplit/Sources/Bonsplit/Internal/Models/TabItem.swift): `Packages/Bonsplit/Sources/Bonsplit/Internal/Models/TabItem.swift`

### Supporting services

- [Settings](https://github.com/nickustinov/itsypad-macos/blob/main/Sources/Settings/SettingsStore.swift): `Sources/Settings/SettingsStore.swift`
- [Cloud sync](https://github.com/nickustinov/itsypad-macos/blob/main/Sources/App/CloudSyncEngine.swift): `Sources/App/CloudSyncEngine.swift`

### Other components

- **Mac user**
- **CloudKit**

## Connections

- Mac user → App lifecycle: launches (evidence: `Sources/App/AppDelegate.swift`)
- App lifecycle → Root window: creates window (evidence: `Sources/App/AppDelegate.swift`)
- App lifecycle → Editor coordinator: routes commands (evidence: `Sources/App/AppDelegate.swift`)
- App lifecycle → Global hotkeys: registers (evidence: `Sources/App/AppDelegate.swift`)
- Global hotkeys → Settings: reads shortcuts (evidence: `Sources/Hotkey/HotkeyManager.swift`)
- App lifecycle → Menu commands: builds menus (evidence: `Sources/App/AppDelegate.swift`)
- Editor coordinator → Text editor: coordinates (evidence: `Sources/App/AppDelegate.swift`)
- Editor coordinator → Tab persistence: persists tabs (evidence: `Sources/App/AppDelegate.swift`)
- Editor coordinator → Markdown preview: updates previews (evidence: `Sources/Editor/MarkdownPreviewManager.swift`)
- Markdown preview → Editor coordinator: notifies changes (evidence: `Sources/Editor/MarkdownPreviewManager.swift`)
- Search overlay → Search matching: searches text (evidence: `Sources/Search/GlobalSearchController.swift`)
- Mac user → Search overlay: requests search
- File browser → File tree: restores folder (evidence: `Sources/FileBrowser/FileBrowserSplitViewController.swift`)
- Mac user → File browser: opens files
- Clipboard interface → Clipboard history: reads history (evidence: `Sources/Clipboard/ClipboardContentView.swift`)
- Clipboard interface → Entry preview: shows preview (evidence: `Sources/Clipboard/ClipboardContentView.swift`)
- Entry preview → Clipboard history: reads entry (evidence: `Sources/Clipboard/ClipboardPreviewOverlay.swift`)
- Clipboard interface → Settings: reads preferences (evidence: `Sources/Clipboard/ClipboardContentView.swift`)
- App lifecycle → Clipboard history: configures history (evidence: `Sources/App/AppDelegate.swift`)
- Root window → Split controller: hosts tabs
- Split controller → Split state: manages layout
- Split state → Tab model: mutates tabs (evidence: `Packages/Bonsplit/Sources/Bonsplit/Internal/Controllers/SplitViewController.swift`)
- Session restoration → Tab persistence: restores sessions (evidence: `Sources/Editor/SessionRestorer.swift`)
- Session restoration → Split controller: restores layout (evidence: `Sources/Editor/SessionRestorer.swift`)
- Settings → Cloud sync: starts sync (evidence: `Sources/Settings/SettingsStore.swift`)
- Cloud sync → Tab persistence: syncs tab data (evidence: `Sources/App/CloudSyncEngine.swift`)
- Cloud sync → Clipboard history: syncs clipboard text (evidence: `Sources/App/CloudSyncEngine.swift`)
- Cloud sync → CloudKit: synchronizes records (evidence: `Sources/App/CloudSyncEngine.swift`)
- Settings → Syntax highlighting: selects theme
