tiptap

Guidance for coding agents integrating and extending the Tiptap rich text editor, intended for building or modifying a Tiptap-based editor, installing extensions, or implementing higher-level features such as collaboration, comments, AI, or document conversion. A central instruction is not to rely on prior assumptions about Tiptap: before implementing anything, consult the actual Tiptap source and documentation so the code matches the library rather than guessing or inventing patterns. To that end, the initial setup clones the tiptap and tiptap-docs repositories into a git-ignored .reference folder (or an existing reference folder), and each task begins by pulling the latest main branch and researching the relevant docs and source.

Best practices are explicit: use the latest stable Tiptap 3, keep every @tiptap/ package on the same version number, read the installation guide when integrating for the first time, and set immediatelyRender to false when server-side rendering (for example Next.js) to avoid crashes. For React, the React Composable API is preferred. The skill requires git.

The feature catalog points each capability to its documentation section and, in some cases, shows the initializing code. Real-time collaboration uses Tiptap Cloud with the Collaboration extension over a Y.Doc and the TiptapCollabProvider (app id and JWT token), with guidance to walk the user through setting up a Tiptap Cloud account when needed. Other features include thread-based comments, tracked changes, import and export to and from DOCX, PDF, and Markdown, AI content generation, AI agent document editing, AI review and proofreading, server-side AI processing, version history via snapshots, snapshot compare, and print-ready pages. Some pro extensions ship through a private npm registry with separate setup instructions.