Open-source manufacturing ERP, MES and QMS. Quoting, MRP, inventory, shop floor, quality and lot/serial traceability on one Postgres schema, with a REST API and MCP server. Self-host or use Carbon Cloud.
@carbon/tiptap
Rich text editor — TipTap extensions, editor components, image handling plugins, and mention support.
Always
- Use the barrel export (
@carbon/tiptap) for all imports — components, extensions, plugins, and utils are all exported fromsrc/index.ts. - Follow the component composition pattern:
EditorRoot>EditorContentwith extensions array. UseEditorBubble/EditorBubbleItemfor floating toolbars,EditorCommand/EditorCommandItemfor slash commands. - Extensions live in
src/extensions/, components insrc/components/. Add new TipTap extensions tosrc/extensions/index.tsbarrel. - Image uploads use the plugin system —
createImageUpload,handleImageDrop,handleImagePastefromsrc/plugins/.
Ask First
- Adding new TipTap extension dependencies (check compatibility with existing extensions)
- Changing the
EditorContentorEditorRootcomponent APIs - Modifying mention or slash-command suggestion behavior
Never
- Import TipTap dependencies directly in app code — use re-exports from
@carbon/tiptap - Modify
@tiptap/coreor@tiptap/pminternals directly — use the extension API
Validation Commands
pnpm --filter @carbon/tiptap typecheck
pnpm --filter @carbon/tiptap lint
Key Exports
Components: EditorRoot, EditorContent, EditorBubble, EditorBubbleItem, EditorCommand, EditorCommandItem, EditorCommandList, MentionList, useEditor
Extensions: StarterKit, Placeholder, TiptapLink, TiptapImage, TiptapUnderline, Color, TextStyle, HighlightExtension, TaskList, TaskItem, CodeBlockLowlight, HorizontalRule, Youtube, CustomKeymap, GlobalDragHandle, AIHighlight, MergeTokenHighlight, MarkdownExtension, Mention, createMentionExtension, createMentionSuggestion
Plugins: UploadImagesPlugin, createImageUpload, handleImageDrop, handleImagePaste
Utils: getPrevText, getAllContent, isValidUrl, getUrlFromString
Converting a document to or from text (Markdown, plain text) is not here: it is TiptapText in @carbon/files/markdown, which runs with no DOM.
Cross-References
@carbon/react— wraps TipTap inEditor/andRichText/sub-exports- Uses
jotaifor editor state atoms (queryAtom,rangeAtom) - Uses
cmdkfor slash-command UI