# jergensturdley/explorerr architecture

> Architecture diagram of the GitHub repository jergensturdley/explorerr, 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/jergensturdley/explorerr
- Repository: https://github.com/jergensturdley/explorerr

## Overview

Explorerr is a native macOS file explorer. Its main workflow is navigating folders and search results in tabs and panes, viewing and selecting items, then opening or managing them. The graph also preserves the documented file-management, special-location, visual, persistence, and integrated-terminal capabilities. Source excerpts and the SOURCE INDEX support the core wiring; README-documented capabilities are included where implementation details were not sampled.

Main entry points: [`Sources/Explorerr/App/MainWindow.swift`](https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/App/MainWindow.swift) (Window composition), [`Sources/Explorerr/Core/TabState.swift`](https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Core/TabState.swift) (Tab navigation state), [`Sources/Explorerr/Core/AppModel.swift`](https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Core/AppModel.swift) (Shared app state), [`Sources/Explorerr/Core/FileOps.swift`](https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Core/FileOps.swift) (File operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application shell"]
  node_app_entry["App entry<br/>[ExplorerrApp.swift]"]
  node_window["Window composition<br/>[MainWindow.swift]"]
  node_commands["Commands and shortcuts<br/>[Commands.swift]"]
  node_app_model["Shared app state<br/>[AppModel.swift]"]
  node_window_model["Pane and window state<br/>[WindowModel.swift]"]
  node_persistence[("Preferences and sessions<br/>[Persistence.swift]")]
end

subgraph group_navigation["Navigation and views"]
  node_chrome["Explorer chrome<br/>[WindowChrome.swift]"]
  node_address["Address and search<br/>[AddressBar.swift]"]
  node_tab_state["Tab navigation state<br/>[TabState.swift]"]
  node_tab_strip["Tab strip<br/>[TabStrip.swift]"]
  node_nav_pane["Navigation pane"]
  node_folder_content["Folder content router"]
  node_folder_views["Folder presentations<br/>[FolderViews.swift]"]
  node_special_views["Home, gallery, trash<br/>[SpecialViews.swift]"]
  node_details["Details and properties"]
  node_quicklook["Quick Look preview<br/>[QuickLook.swift]"]
end

subgraph group_files["Filesystem operations"]
  node_directory["Directory and search"]
  node_file_ops["File operations<br/>[FileOps.swift]"]
  node_disk_access["Disk access<br/>[DiskAccess.swift]"]
end

subgraph group_terminal["Integrated terminal"]
  node_terminal_panel["Terminal panel"]
  node_terminal_controller["Terminal controller"]
  node_terminal_emulator["Terminal emulator"]
  node_pty["PTY process<br/>[PtyProcess.swift]"]
end

node_user(("Explorer user"))
node_filesystem[("macOS filesystem")]
node_shell(("Login shell"))

node_user -->|"launches"| node_app_entry
node_app_entry -->|"shows"| node_window
node_window -->|"composes"| node_window_model
node_window -->|"shows"| node_folder_content
node_window -->|"shows"| node_nav_pane
node_window -->|"shows"| node_terminal_panel
node_window -->|"shows"| node_details
node_window -.->|"frames"| node_chrome
node_user -->|"invokes"| node_commands
node_commands -->|"requests changes"| node_file_ops
node_commands -->|"reads active tab"| node_tab_state
node_address -->|"navigates"| node_tab_state
node_address -->|"opens files"| node_file_ops
node_tab_strip -->|"switches tabs"| node_tab_state
node_tab_state -->|"loads and searches"| node_directory
node_tab_state -->|"updates shared state"| node_app_model
node_folder_content -->|"reads selection"| node_tab_state
node_folder_content -->|"transfers items"| node_file_ops
node_folder_content -->|"renders listings"| node_folder_views
node_nav_pane -->|"navigates locations"| node_tab_state
node_nav_pane -.->|"offers locations"| node_special_views
node_details -->|"previews items"| node_quicklook
node_special_views -->|"reads locations"| node_directory
node_app_model -->|"manages windows"| node_window_model
node_app_model -->|"queries folders"| node_directory
node_app_model -->|"coordinates changes"| node_file_ops
node_app_model -->|"saves state"| node_persistence
node_window_model -->|"restores layout"| node_persistence
node_directory -->|"enumerates and searches"| node_filesystem
node_file_ops -->|"reads and mutates"| node_filesystem
node_disk_access -->|"accesses volumes"| node_filesystem
node_terminal_panel -->|"sends input"| node_terminal_controller
node_terminal_controller -->|"starts and writes"| node_pty
node_terminal_controller -->|"feeds output"| node_terminal_emulator
node_pty -->|"runs"| node_shell
node_window -->|"owns terminal"| node_terminal_controller

click node_app_entry "https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/App/ExplorerrApp.swift"
click node_window "https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/App/MainWindow.swift"
click node_commands "https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/App/Commands.swift"
click node_app_model "https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Core/AppModel.swift"
click node_window_model "https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Core/WindowModel.swift"
click node_persistence "https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Core/Persistence.swift"
click node_chrome "https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Chrome/WindowChrome.swift"
click node_address "https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Chrome/AddressBar.swift"
click node_tab_state "https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Core/TabState.swift"
click node_tab_strip "https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Chrome/TabStrip.swift"
click node_nav_pane "https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Views/NavigationPane.swift"
click node_folder_content "https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Views/FolderContentView.swift"
click node_folder_views "https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Views/FolderViews.swift"
click node_special_views "https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Views/SpecialViews.swift"
click node_details "https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Views/DetailsPaneView.swift"
click node_quicklook "https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Chrome/QuickLook.swift"
click node_directory "https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Core/DirectoryLoader.swift"
click node_file_ops "https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Core/FileOps.swift"
click node_disk_access "https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Core/DiskAccess.swift"
click node_terminal_panel "https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Views/TerminalPanelView.swift"
click node_terminal_controller "https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Core/TerminalController.swift"
click node_terminal_emulator "https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Core/TerminalEmulator.swift"
click node_pty "https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Core/PtyProcess.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_entry,node_window,node_commands,node_app_model,node_window_model,node_persistence,node_user toneBlue
class node_chrome,node_address,node_tab_state,node_tab_strip,node_nav_pane,node_folder_content,node_folder_views,node_special_views,node_details,node_quicklook,node_filesystem toneAmber
class node_directory,node_file_ops,node_disk_access toneMint
class node_terminal_panel,node_terminal_controller,node_terminal_emulator,node_pty toneRose
class node_shell toneIndigo
```

## Components

### Application shell

- [App entry](https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/App/ExplorerrApp.swift): `Sources/Explorerr/App/ExplorerrApp.swift`
- [Window composition](https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/App/MainWindow.swift): `Sources/Explorerr/App/MainWindow.swift`
- [Commands and shortcuts](https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/App/Commands.swift): `Sources/Explorerr/App/Commands.swift`
- [Shared app state](https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Core/AppModel.swift): `Sources/Explorerr/Core/AppModel.swift`
- [Pane and window state](https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Core/WindowModel.swift): `Sources/Explorerr/Core/WindowModel.swift`
- [Preferences and sessions](https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Core/Persistence.swift): `Sources/Explorerr/Core/Persistence.swift`

### Navigation and views

- [Explorer chrome](https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Chrome/WindowChrome.swift): `Sources/Explorerr/Chrome/WindowChrome.swift`
- [Address and search](https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Chrome/AddressBar.swift): `Sources/Explorerr/Chrome/AddressBar.swift`
- [Tab navigation state](https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Core/TabState.swift): `Sources/Explorerr/Core/TabState.swift`
- [Tab strip](https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Chrome/TabStrip.swift): `Sources/Explorerr/Chrome/TabStrip.swift`
- [Navigation pane](https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Views/NavigationPane.swift): `Sources/Explorerr/Views/NavigationPane.swift`
- [Folder content router](https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Views/FolderContentView.swift): `Sources/Explorerr/Views/FolderContentView.swift`
- [Folder presentations](https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Views/FolderViews.swift): `Sources/Explorerr/Views/FolderViews.swift`
- [Home, gallery, trash](https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Views/SpecialViews.swift): `Sources/Explorerr/Views/SpecialViews.swift`
- [Details and properties](https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Views/DetailsPaneView.swift): `Sources/Explorerr/Views/DetailsPaneView.swift`
- [Quick Look preview](https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Chrome/QuickLook.swift): `Sources/Explorerr/Chrome/QuickLook.swift`

### Filesystem operations

- [Directory and search](https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Core/DirectoryLoader.swift): `Sources/Explorerr/Core/DirectoryLoader.swift`
- [File operations](https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Core/FileOps.swift): `Sources/Explorerr/Core/FileOps.swift`
- [Disk access](https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Core/DiskAccess.swift): `Sources/Explorerr/Core/DiskAccess.swift`

### Integrated terminal

- [Terminal panel](https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Views/TerminalPanelView.swift): `Sources/Explorerr/Views/TerminalPanelView.swift`
- [Terminal controller](https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Core/TerminalController.swift): `Sources/Explorerr/Core/TerminalController.swift`
- [Terminal emulator](https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Core/TerminalEmulator.swift): `Sources/Explorerr/Core/TerminalEmulator.swift`
- [PTY process](https://github.com/jergensturdley/explorerr/blob/main/Sources/Explorerr/Core/PtyProcess.swift): `Sources/Explorerr/Core/PtyProcess.swift`

### Other components

- **Explorer user**
- **macOS filesystem**
- **Login shell**

## Connections

- Explorer user → App entry: launches (evidence: `README.md`)
- App entry → Window composition: shows (evidence: `Sources/Explorerr/App/ExplorerrApp.swift`)
- Window composition → Pane and window state: composes (evidence: `Sources/Explorerr/App/MainWindow.swift`)
- Window composition → Folder content router: shows (evidence: `Sources/Explorerr/App/MainWindow.swift`)
- Window composition → Navigation pane: shows (evidence: `Sources/Explorerr/App/MainWindow.swift`)
- Window composition → Terminal panel: shows (evidence: `Sources/Explorerr/App/MainWindow.swift`)
- Window composition → Details and properties: shows (evidence: `Sources/Explorerr/App/MainWindow.swift`)
- Window composition → Explorer chrome: frames
- Explorer user → Commands and shortcuts: invokes (evidence: `Sources/Explorerr/App/Commands.swift`)
- Commands and shortcuts → File operations: requests changes (evidence: `Sources/Explorerr/App/Commands.swift`)
- Commands and shortcuts → Tab navigation state: reads active tab (evidence: `Sources/Explorerr/App/Commands.swift`)
- Address and search → Tab navigation state: navigates (evidence: `Sources/Explorerr/Chrome/AddressBar.swift`)
- Address and search → File operations: opens files (evidence: `Sources/Explorerr/Chrome/AddressBar.swift`)
- Tab strip → Tab navigation state: switches tabs (evidence: `Sources/Explorerr/Chrome/TabStrip.swift`)
- Tab navigation state → Directory and search: loads and searches (evidence: `Sources/Explorerr/Core/TabState.swift`)
- Tab navigation state → Shared app state: updates shared state (evidence: `Sources/Explorerr/Core/TabState.swift`)
- Folder content router → Tab navigation state: reads selection (evidence: `Sources/Explorerr/Views/FolderContentView.swift`)
- Folder content router → File operations: transfers items (evidence: `Sources/Explorerr/Views/FolderContentView.swift`)
- Folder content router → Folder presentations: renders listings (evidence: `Sources/Explorerr/Views/FolderContentView.swift`)
- Navigation pane → Tab navigation state: navigates locations (evidence: `Sources/Explorerr/Views/NavigationPane.swift`)
- Navigation pane → Home, gallery, trash: offers locations
- Details and properties → Quick Look preview: previews items (evidence: `Sources/Explorerr/Views/DetailsPaneView.swift`)
- Home, gallery, trash → Directory and search: reads locations (evidence: `Sources/Explorerr/Views/SpecialViews.swift`)
- Shared app state → Pane and window state: manages windows (evidence: `Sources/Explorerr/Core/AppModel.swift`)
- Shared app state → Directory and search: queries folders (evidence: `Sources/Explorerr/Core/AppModel.swift`)
- Shared app state → File operations: coordinates changes (evidence: `Sources/Explorerr/Core/AppModel.swift`)
- Shared app state → Preferences and sessions: saves state (evidence: `Sources/Explorerr/Core/AppModel.swift`)
- Pane and window state → Preferences and sessions: restores layout (evidence: `Sources/Explorerr/Core/WindowModel.swift`)
- Directory and search → macOS filesystem: enumerates and searches (evidence: `Sources/Explorerr/Core/DirectoryLoader.swift`)
- File operations → macOS filesystem: reads and mutates (evidence: `Sources/Explorerr/Core/FileOps.swift`)
- Disk access → macOS filesystem: accesses volumes (evidence: `README.md`)
- Terminal panel → Terminal controller: sends input (evidence: `Sources/Explorerr/Views/TerminalPanelView.swift`)
- Terminal controller → PTY process: starts and writes (evidence: `Sources/Explorerr/Core/TerminalController.swift`)
- Terminal controller → Terminal emulator: feeds output (evidence: `Sources/Explorerr/Core/TerminalController.swift`)
- PTY process → Login shell: runs (evidence: `README.md`)
- Window composition → Terminal controller: owns terminal (evidence: `Sources/Explorerr/App/MainWindow.swift`)
