How ueberdosis/tiptap works
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: Editor.ts Editor instance · ExtensionManager.ts Extension manager · CommandManager.ts Command manager · drag-handle-plugin.ts Drag handle
Components 17
Editor core
- Editor instance
packages/core/src/Editor.ts - Extension manager
packages/core/src/ExtensionManager.ts - Command manager
packages/core/src/CommandManager.ts - Decoration manager
packages/core/src/decorations/DecorationManager.ts - Editor state
packages/core/src/Editor.ts
Editing extensions
- Extension ecosystem
packages - Drag handle
packages/extension-drag-handle/src/drag-handle-plugin.ts - File handling
packages/extension-file-handler/src/fileHandler.ts
Content formats
- Markdown conversion
packages/markdown/src/MarkdownManager.ts - HTML conversion
packages/html/src/getHTMLFromFragment.ts
Collaboration and AI
- Collaboration extension
packages/extension-collaboration/src/collaboration.ts - Yjs binding
packages/y-tiptap/src/lib/utils/reconciliation/updateYFragment.ts - AI toolkit
packages/ai-toolkit/src/server-ai-toolkit-extension.ts
Framework adapters
- React adapter
packages/react/src/useEditor.ts - Vue adapter
packages/vue/src/useEditor.ts
Other components
- Editor user
- ProseMirror
Connections 20
- Editor user → Editor instance: edits with
README.md - React adapter → Editor instance: adapts
packages/react/src/useEditor.ts - Vue adapter → Editor instance: adapts
packages/vue/src/useEditor.ts - Editor instance → Extension manager: configures
packages/core/src/Editor.ts - Editor instance → Command manager: creates
packages/core/src/Editor.ts - Editor instance → Editor state: manages
packages/core/src/Editor.ts - Extension manager → Decoration manager: creates
packages/core/src/ExtensionManager.ts - Extension manager → Extension ecosystem: resolves
packages/core/src/ExtensionManager.ts - Extension manager → ProseMirror: builds schema
packages/core/src/ExtensionManager.ts - Command manager → Editor state: dispatches changes
packages/core/src/CommandManager.ts - Editor state → ProseMirror: uses
packages/core/src/Editor.ts - Editor user → Markdown conversion: imports or exports
README.md - Editor user → HTML conversion: uses HTML output
README.md - Editor user → Drag handle: uses block editing
README.md - Editor user → File handling: uses file handling
- Editor user → Collaboration extension: enables collaboration
README.md - Collaboration extension → Yjs binding: binds documents
README.md - Editor user → AI toolkit: uses AI features
README.md - Drag handle → Editor instance: reads editor state
packages/extension-drag-handle/src/drag-handle-plugin.ts - File handling → Editor instance: registers plugin
packages/extension-file-handler/src/fileHandler.ts