# lieonshelly/ymind architecture

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

- Interactive diagram: https://gitdiagram.com/lieonshelly/ymind
- Repository: https://github.com/lieonshelly/ymind

## Overview

YMIndApp is a native mind-mapping app: users create or open a map, edit and arrange its nodes, then save or export it. The session coordinates the editable document, commands, layout, camera, and autosave; the canvas presents the resulting map and supports interaction. Import formats, recovery, clipboard/drop handling, and image export are additional product capabilities. Relationship evidence is limited to the supplied excerpts and SOURCE INDEX references; unsampled importer and export wiring is not asserted.

Main entry points: [`YMindApp/YMindApp/Session/DocumentSession.swift`](https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Session/DocumentSession.swift) (Document session), [`YMindApp/YMindApp/ContentView.swift`](https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/ContentView.swift) (Main view), [`YMindApp/YMindApp/Render/CanvasMetalView.swift`](https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Render/CanvasMetalView.swift) (Canvas view), [`YMindApp/YMindApp/YMindAppApp.swift`](https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/YMindAppApp.swift) (App entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["App interface"]
  node_app["App entry<br/>[YMindAppApp.swift]"]
  node_mainview["Main view<br/>[ContentView.swift]"]
  node_toolbar["Toolbar<br/>[MainToolbar.swift]"]
  node_editor["Node editor"]
  node_search["Search bar<br/>[SearchBar.swift]"]
  node_importpreview["Import preview"]
  node_recovery["Recovery banner"]
end

subgraph group_editing["Document editing"]
  node_session["Document session"]
  node_model["Mind map model<br/>[MindMapModel.swift]"]
  node_commands["Command history<br/>[CommandBus.swift]"]
  node_clipboard["Clipboard<br/>[Clipboard.swift]"]
  node_drop["Drop intent<br/>[DropIntent.swift]"]
  node_autosave[("Autosave store")]
end

subgraph group_geometry["Layout and rendering"]
  node_camera["Camera<br/>[Camera.swift]"]
  node_layout["Radial layout<br/>[RadialLayout.swift]"]
  node_measure["Text measurement<br/>[TextMeasure.swift]"]
  node_snapshot["Layout snapshot"]
  node_canvas["Canvas view"]
  node_renderer["Metal renderer"]
end

subgraph group_formats["Import and export"]
  node_importregistry["Import dispatch"]
  node_markdownimport["Markdown import"]
  node_xmlimport["XML import<br/>[XMLImporters.swift]"]
  node_codec["Native document codec<br/>[YMindCodec.swift]"]
  node_markdownexport["Markdown export"]
  node_pngexport["PNG export<br/>[PNGExporter.swift]"]
end

node_user(("Map user"))

node_user -->|"launches"| node_app
node_app -->|"presents"| node_mainview
node_mainview -->|"uses"| node_session
node_mainview -->|"presents"| node_canvas
node_mainview -->|"presents"| node_toolbar
node_mainview -->|"presents"| node_editor
node_mainview -->|"presents"| node_search
node_mainview -->|"presents"| node_importpreview
node_mainview -->|"presents"| node_recovery
node_session -->|"updates"| node_model
node_session -->|"creates"| node_commands
node_commands -->|"mutates"| node_model
node_session -->|"relayouts"| node_layout
node_layout -->|"measures text"| node_measure
node_layout -->|"produces"| node_snapshot
node_session -->|"writes drafts"| node_autosave
node_session -->|"encodes documents"| node_codec
node_session -->|"maintains"| node_camera
node_canvas -->|"interacts with"| node_session
node_canvas -->|"draws through"| node_renderer
node_canvas -->|"uses"| node_camera
node_canvas -->|"uses"| node_drop
node_renderer -->|"renders"| node_snapshot
node_renderer -->|"renders intent"| node_drop
node_session -.->|"loads imports"| node_importregistry
node_importregistry -.->|"dispatches"| node_markdownimport
node_importregistry -.->|"dispatches"| node_xmlimport
node_markdownimport -.->|"previews result"| node_importpreview
node_user -.->|"copies and pastes"| node_clipboard
node_app -->|"exports"| node_markdownexport
node_app -->|"exports"| node_pngexport
node_session -->|"saves documents"| node_codec

click node_app "https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/YMindAppApp.swift"
click node_mainview "https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/ContentView.swift"
click node_toolbar "https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/App/MainToolbar.swift"
click node_editor "https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/App/NodeEditorOverlay.swift"
click node_search "https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/App/SearchBar.swift"
click node_importpreview "https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/App/ImportPreviewView.swift"
click node_recovery "https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/App/RecoveryBannerView.swift"
click node_session "https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Session/DocumentSession.swift"
click node_model "https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Model/MindMapModel.swift"
click node_commands "https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Commands/CommandBus.swift"
click node_clipboard "https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Session/Clipboard.swift"
click node_drop "https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Session/DropIntent.swift"
click node_autosave "https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Session/AutosaveStore.swift"
click node_camera "https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Session/Camera.swift"
click node_layout "https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Layout/RadialLayout.swift"
click node_measure "https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Layout/TextMeasure.swift"
click node_snapshot "https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Layout/LayoutSnapshot.swift"
click node_canvas "https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Render/CanvasMetalView.swift"
click node_renderer "https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Render/MetalRenderer.swift"
click node_importregistry "https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Model/DocumentImporter.swift"
click node_markdownimport "https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Model/MarkdownImporter.swift"
click node_xmlimport "https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Model/XMLImporters.swift"
click node_codec "https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Model/YMindCodec.swift"
click node_markdownexport "https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Model/MarkdownExporter.swift"
click node_pngexport "https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Render/PNGExporter.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_mainview,node_toolbar,node_editor,node_search,node_importpreview,node_recovery,node_user toneBlue
class node_session,node_model,node_commands,node_clipboard,node_drop,node_autosave toneAmber
class node_camera,node_layout,node_measure,node_snapshot,node_canvas,node_renderer toneMint
class node_importregistry,node_markdownimport,node_xmlimport,node_codec,node_markdownexport,node_pngexport toneRose
```

## Components

### App interface

- [App entry](https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/YMindAppApp.swift): `YMindApp/YMindApp/YMindAppApp.swift`
- [Main view](https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/ContentView.swift): `YMindApp/YMindApp/ContentView.swift`
- [Toolbar](https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/App/MainToolbar.swift): `YMindApp/YMindApp/App/MainToolbar.swift`
- [Node editor](https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/App/NodeEditorOverlay.swift): `YMindApp/YMindApp/App/NodeEditorOverlay.swift`
- [Search bar](https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/App/SearchBar.swift): `YMindApp/YMindApp/App/SearchBar.swift`
- [Import preview](https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/App/ImportPreviewView.swift): `YMindApp/YMindApp/App/ImportPreviewView.swift`
- [Recovery banner](https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/App/RecoveryBannerView.swift): `YMindApp/YMindApp/App/RecoveryBannerView.swift`

### Document editing

- [Document session](https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Session/DocumentSession.swift): `YMindApp/YMindApp/Session/DocumentSession.swift`
- [Mind map model](https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Model/MindMapModel.swift): `YMindApp/YMindApp/Model/MindMapModel.swift`
- [Command history](https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Commands/CommandBus.swift): `YMindApp/YMindApp/Commands/CommandBus.swift`
- [Clipboard](https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Session/Clipboard.swift): `YMindApp/YMindApp/Session/Clipboard.swift`
- [Drop intent](https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Session/DropIntent.swift): `YMindApp/YMindApp/Session/DropIntent.swift`
- [Autosave store](https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Session/AutosaveStore.swift): `YMindApp/YMindApp/Session/AutosaveStore.swift`

### Layout and rendering

- [Camera](https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Session/Camera.swift): `YMindApp/YMindApp/Session/Camera.swift`
- [Radial layout](https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Layout/RadialLayout.swift): `YMindApp/YMindApp/Layout/RadialLayout.swift`
- [Text measurement](https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Layout/TextMeasure.swift): `YMindApp/YMindApp/Layout/TextMeasure.swift`
- [Layout snapshot](https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Layout/LayoutSnapshot.swift): `YMindApp/YMindApp/Layout/LayoutSnapshot.swift`
- [Canvas view](https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Render/CanvasMetalView.swift): `YMindApp/YMindApp/Render/CanvasMetalView.swift`
- [Metal renderer](https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Render/MetalRenderer.swift): `YMindApp/YMindApp/Render/MetalRenderer.swift`

### Import and export

- [Import dispatch](https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Model/DocumentImporter.swift): `YMindApp/YMindApp/Model/DocumentImporter.swift`
- [Markdown import](https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Model/MarkdownImporter.swift): `YMindApp/YMindApp/Model/MarkdownImporter.swift`
- [XML import](https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Model/XMLImporters.swift): `YMindApp/YMindApp/Model/XMLImporters.swift`
- [Native document codec](https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Model/YMindCodec.swift): `YMindApp/YMindApp/Model/YMindCodec.swift`
- [Markdown export](https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Model/MarkdownExporter.swift): `YMindApp/YMindApp/Model/MarkdownExporter.swift`
- [PNG export](https://github.com/lieonshelly/ymind/blob/main/YMindApp/YMindApp/Render/PNGExporter.swift): `YMindApp/YMindApp/Render/PNGExporter.swift`

### Other components

- **Map user**

## Connections

- Map user → App entry: launches (evidence: `YMindApp/YMindApp/YMindAppApp.swift`)
- App entry → Main view: presents (evidence: `YMindApp/YMindApp/YMindAppApp.swift`)
- Main view → Document session: uses (evidence: `YMindApp/YMindApp/ContentView.swift`)
- Main view → Canvas view: presents (evidence: `YMindApp/YMindApp/ContentView.swift`)
- Main view → Toolbar: presents (evidence: `YMindApp/YMindApp/ContentView.swift`)
- Main view → Node editor: presents (evidence: `YMindApp/YMindApp/ContentView.swift`)
- Main view → Search bar: presents (evidence: `YMindApp/YMindApp/ContentView.swift`)
- Main view → Import preview: presents (evidence: `YMindApp/YMindApp/ContentView.swift`)
- Main view → Recovery banner: presents (evidence: `YMindApp/YMindApp/ContentView.swift`)
- Document session → Mind map model: updates (evidence: `YMindApp/YMindApp/Session/DocumentSession.swift`)
- Document session → Command history: creates (evidence: `YMindApp/YMindApp/Session/DocumentSession.swift`)
- Command history → Mind map model: mutates (evidence: `YMindApp/YMindApp/Commands/CommandBus.swift`)
- Document session → Radial layout: relayouts (evidence: `YMindApp/YMindApp/Session/DocumentSession.swift`)
- Radial layout → Text measurement: measures text (evidence: `YMindApp/YMindApp/Layout/RadialLayout.swift`)
- Radial layout → Layout snapshot: produces (evidence: `YMindApp/YMindApp/Layout/RadialLayout.swift`)
- Document session → Autosave store: writes drafts (evidence: `YMindApp/YMindApp/Session/DocumentSession.swift`)
- Document session → Native document codec: encodes documents (evidence: `YMindApp/YMindApp/Session/DocumentSession.swift`)
- Document session → Camera: maintains (evidence: `YMindApp/YMindApp/Session/DocumentSession.swift`)
- Canvas view → Document session: interacts with (evidence: `YMindApp/YMindApp/Render/CanvasMetalView.swift`)
- Canvas view → Metal renderer: draws through (evidence: `YMindApp/YMindApp/Render/CanvasMetalView.swift`)
- Canvas view → Camera: uses (evidence: `YMindApp/YMindApp/Render/CanvasMetalView.swift`)
- Canvas view → Drop intent: uses (evidence: `YMindApp/YMindApp/Render/CanvasMetalView.swift`)
- Metal renderer → Layout snapshot: renders (evidence: `YMindApp/YMindApp/Render/MetalRenderer.swift`)
- Metal renderer → Drop intent: renders intent (evidence: `YMindApp/YMindApp/Render/MetalRenderer.swift`)
- Document session → Import dispatch: loads imports
- Import dispatch → Markdown import: dispatches (evidence: `YMindApp/YMindApp/Model/MarkdownImporter.swift`)
- Import dispatch → XML import: dispatches
- Markdown import → Import preview: previews result
- Map user → Clipboard: copies and pastes
- App entry → Markdown export: exports (evidence: `YMindApp/YMindApp/YMindAppApp.swift`)
- App entry → PNG export: exports (evidence: `YMindApp/YMindApp/YMindAppApp.swift`)
- Document session → Native document codec: saves documents (evidence: `YMindApp/YMindApp/Session/DocumentSession.swift`)
