# ueberdosis/tiptap architecture

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

- Interactive diagram: https://gitdiagram.com/ueberdosis/tiptap
- Repository: https://github.com/ueberdosis/tiptap

## Overview

Tiptap is a headless, framework-agnostic rich-text editor built on ProseMirror and extended through composable packages. A user edits content through an editor instance configured with extensions; the core manages schema, commands, editor state, and decorations, while format, framework, collaboration, and AI packages add distinct capabilities. The README documents these product branches, and the source index supports several core and integration links. Many extension implementations were not sampled, so their connections are shown only where documented or marked unverified.

Main entry points: [`packages/core/src/Editor.ts`](https://github.com/ueberdosis/tiptap/blob/main/packages/core/src/Editor.ts) (Editor instance), [`packages/core/src/ExtensionManager.ts`](https://github.com/ueberdosis/tiptap/blob/main/packages/core/src/ExtensionManager.ts) (Extension manager), [`packages/core/src/CommandManager.ts`](https://github.com/ueberdosis/tiptap/blob/main/packages/core/src/CommandManager.ts) (Command manager), [`packages/extension-drag-handle/src/drag-handle-plugin.ts`](https://github.com/ueberdosis/tiptap/blob/main/packages/extension-drag-handle/src/drag-handle-plugin.ts) (Drag handle)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Editor core"]
  node_editor["Editor instance<br/>[Editor.ts]"]
  node_extension_manager["Extension manager"]
  node_commands["Command manager<br/>[CommandManager.ts]"]
  node_decorations["Decoration manager"]
  node_editor_state["Editor state<br/>[Editor.ts]"]
end

subgraph group_extensions["Editing extensions"]
  node_extension_set["Extension ecosystem"]
  node_drag_handle["Drag handle"]
  node_file_handler["File handling<br/>[fileHandler.ts]"]
end

subgraph group_formats["Content formats"]
  node_markdown["Markdown conversion<br/>[MarkdownManager.ts]"]
  node_html["HTML conversion"]
end

subgraph group_integrations["Collaboration and AI"]
  node_collaboration["Collaboration extension<br/>[collaboration.ts]"]
  node_y_tiptap["Yjs binding<br/>[updateYFragment.ts]"]
  node_ai_toolkit["AI toolkit"]
end

subgraph group_frameworks["Framework adapters"]
  node_react["React adapter<br/>[useEditor.ts]"]
  node_vue["Vue adapter<br/>[useEditor.ts]"]
end

node_user(("Editor user"))
node_prosemirror["ProseMirror"]

node_user -->|"edits with"| node_editor
node_react -->|"adapts"| node_editor
node_vue -->|"adapts"| node_editor
node_editor -->|"configures"| node_extension_manager
node_editor -->|"creates"| node_commands
node_editor -->|"manages"| node_editor_state
node_extension_manager -->|"creates"| node_decorations
node_extension_manager -.->|"resolves"| node_extension_set
node_extension_manager -->|"builds schema"| node_prosemirror
node_commands -->|"dispatches changes"| node_editor_state
node_editor_state -->|"uses"| node_prosemirror
node_user -.->|"imports or exports"| node_markdown
node_user -.->|"uses HTML output"| node_html
node_user -.->|"uses block editing"| node_drag_handle
node_user -.->|"uses file handling"| node_file_handler
node_user -->|"enables collaboration"| node_collaboration
node_collaboration -.->|"binds documents"| node_y_tiptap
node_user -->|"uses AI features"| node_ai_toolkit
node_drag_handle -->|"reads editor state"| node_editor
node_file_handler -->|"registers plugin"| node_editor

click node_editor "https://github.com/ueberdosis/tiptap/blob/main/packages/core/src/Editor.ts"
click node_extension_manager "https://github.com/ueberdosis/tiptap/blob/main/packages/core/src/ExtensionManager.ts"
click node_commands "https://github.com/ueberdosis/tiptap/blob/main/packages/core/src/CommandManager.ts"
click node_decorations "https://github.com/ueberdosis/tiptap/blob/main/packages/core/src/decorations/DecorationManager.ts"
click node_editor_state "https://github.com/ueberdosis/tiptap/blob/main/packages/core/src/Editor.ts"
click node_extension_set "https://github.com/ueberdosis/tiptap/tree/main/packages"
click node_drag_handle "https://github.com/ueberdosis/tiptap/blob/main/packages/extension-drag-handle/src/drag-handle-plugin.ts"
click node_file_handler "https://github.com/ueberdosis/tiptap/blob/main/packages/extension-file-handler/src/fileHandler.ts"
click node_markdown "https://github.com/ueberdosis/tiptap/blob/main/packages/markdown/src/MarkdownManager.ts"
click node_html "https://github.com/ueberdosis/tiptap/blob/main/packages/html/src/getHTMLFromFragment.ts"
click node_collaboration "https://github.com/ueberdosis/tiptap/blob/main/packages/extension-collaboration/src/collaboration.ts"
click node_y_tiptap "https://github.com/ueberdosis/tiptap/blob/main/packages/y-tiptap/src/lib/utils/reconciliation/updateYFragment.ts"
click node_ai_toolkit "https://github.com/ueberdosis/tiptap/blob/main/packages/ai-toolkit/src/server-ai-toolkit-extension.ts"
click node_react "https://github.com/ueberdosis/tiptap/blob/main/packages/react/src/useEditor.ts"
click node_vue "https://github.com/ueberdosis/tiptap/blob/main/packages/vue/src/useEditor.ts"

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_editor,node_extension_manager,node_commands,node_decorations,node_editor_state,node_user toneBlue
class node_extension_set,node_drag_handle,node_file_handler toneAmber
class node_markdown,node_html toneMint
class node_collaboration,node_y_tiptap,node_ai_toolkit toneRose
class node_react,node_vue,node_prosemirror toneIndigo
```

## Components

### Editor core

- [Editor instance](https://github.com/ueberdosis/tiptap/blob/main/packages/core/src/Editor.ts): `packages/core/src/Editor.ts`
- [Extension manager](https://github.com/ueberdosis/tiptap/blob/main/packages/core/src/ExtensionManager.ts): `packages/core/src/ExtensionManager.ts`
- [Command manager](https://github.com/ueberdosis/tiptap/blob/main/packages/core/src/CommandManager.ts): `packages/core/src/CommandManager.ts`
- [Decoration manager](https://github.com/ueberdosis/tiptap/blob/main/packages/core/src/decorations/DecorationManager.ts): `packages/core/src/decorations/DecorationManager.ts`
- [Editor state](https://github.com/ueberdosis/tiptap/blob/main/packages/core/src/Editor.ts): `packages/core/src/Editor.ts`

### Editing extensions

- [Extension ecosystem](https://github.com/ueberdosis/tiptap/tree/main/packages): `packages`
- [Drag handle](https://github.com/ueberdosis/tiptap/blob/main/packages/extension-drag-handle/src/drag-handle-plugin.ts): `packages/extension-drag-handle/src/drag-handle-plugin.ts`
- [File handling](https://github.com/ueberdosis/tiptap/blob/main/packages/extension-file-handler/src/fileHandler.ts): `packages/extension-file-handler/src/fileHandler.ts`

### Content formats

- [Markdown conversion](https://github.com/ueberdosis/tiptap/blob/main/packages/markdown/src/MarkdownManager.ts): `packages/markdown/src/MarkdownManager.ts`
- [HTML conversion](https://github.com/ueberdosis/tiptap/blob/main/packages/html/src/getHTMLFromFragment.ts): `packages/html/src/getHTMLFromFragment.ts`

### Collaboration and AI

- [Collaboration extension](https://github.com/ueberdosis/tiptap/blob/main/packages/extension-collaboration/src/collaboration.ts): `packages/extension-collaboration/src/collaboration.ts`
- [Yjs binding](https://github.com/ueberdosis/tiptap/blob/main/packages/y-tiptap/src/lib/utils/reconciliation/updateYFragment.ts): `packages/y-tiptap/src/lib/utils/reconciliation/updateYFragment.ts`
- [AI toolkit](https://github.com/ueberdosis/tiptap/blob/main/packages/ai-toolkit/src/server-ai-toolkit-extension.ts): `packages/ai-toolkit/src/server-ai-toolkit-extension.ts`

### Framework adapters

- [React adapter](https://github.com/ueberdosis/tiptap/blob/main/packages/react/src/useEditor.ts): `packages/react/src/useEditor.ts`
- [Vue adapter](https://github.com/ueberdosis/tiptap/blob/main/packages/vue/src/useEditor.ts): `packages/vue/src/useEditor.ts`

### Other components

- **Editor user**
- **ProseMirror**

## Connections

- Editor user → Editor instance: edits with (evidence: `README.md`)
- React adapter → Editor instance: adapts (evidence: `packages/react/src/useEditor.ts`)
- Vue adapter → Editor instance: adapts (evidence: `packages/vue/src/useEditor.ts`)
- Editor instance → Extension manager: configures (evidence: `packages/core/src/Editor.ts`)
- Editor instance → Command manager: creates (evidence: `packages/core/src/Editor.ts`)
- Editor instance → Editor state: manages (evidence: `packages/core/src/Editor.ts`)
- Extension manager → Decoration manager: creates (evidence: `packages/core/src/ExtensionManager.ts`)
- Extension manager → Extension ecosystem: resolves (evidence: `packages/core/src/ExtensionManager.ts`)
- Extension manager → ProseMirror: builds schema (evidence: `packages/core/src/ExtensionManager.ts`)
- Command manager → Editor state: dispatches changes (evidence: `packages/core/src/CommandManager.ts`)
- Editor state → ProseMirror: uses (evidence: `packages/core/src/Editor.ts`)
- Editor user → Markdown conversion: imports or exports (evidence: `README.md`)
- Editor user → HTML conversion: uses HTML output (evidence: `README.md`)
- Editor user → Drag handle: uses block editing (evidence: `README.md`)
- Editor user → File handling: uses file handling
- Editor user → Collaboration extension: enables collaboration (evidence: `README.md`)
- Collaboration extension → Yjs binding: binds documents (evidence: `README.md`)
- Editor user → AI toolkit: uses AI features (evidence: `README.md`)
- Drag handle → Editor instance: reads editor state (evidence: `packages/extension-drag-handle/src/drag-handle-plugin.ts`)
- File handling → Editor instance: registers plugin (evidence: `packages/extension-file-handler/src/fileHandler.ts`)
