@tiptap/core
v3.22.2 MITheadless rich text editor
@tiptap/core Download Trends
About @tiptap/core
Tiptap Core, version 3.22.2, is a headless rich text editor framework built on top of ProseMirror. It provides a server-rendered, framework-agnostic foundation for building custom content editing experiences without imposing a predefined UI. The core problem it solves is decoupling the complex logic of rich text editing from the presentation layer, enabling developers to integrate powerful editing capabilities into any web application with complete control over the user interface.
Its philosophy centers on renderless components and a declarative API, empowering developers to construct unique editing features. Tiptap is designed for developers who need fine-grained control over the editor's behavior and appearance, rather than a pre-styled, out-of-the-box solution. This approach appeals to those building custom design systems or integrating editing into bespoke application frameworks.
The API revolves around a mutable editor instance and extensions, allowing custom command functions, key bindings, and node/mark definitions. Key features include the `useEditor` hook (for integrating with frameworks like React and Vue) and the ability to extend ProseMirror's capabilities with custom JSON schema and collaborative editing support. Developers define editor state and behavior through configuration objects passed to the editor instance.
Tiptap Core is designed for seamless integration with popular JavaScript frameworks such as React and Vue, as well as vanilla JavaScript projects. Its framework-agnostic nature means it can be adapted to various build tools and architectural patterns. By abstracting the UI, it facilitates integration into existing component libraries and design systems, promoting code reusability and consistency across projects.
The package boasts a relatively lean footprint, with an unpacked size of 2.3 MB and a gzipped bundle size of 92.0 kB. This makes it suitable for applications where bundle size is a concern. With 36.0K GitHub stars and 8.1M weekly downloads, Tiptap Core indicates a mature and widely adopted open-source project with significant community backing. The last update was on April 4, 2026, suggesting active maintenance.
However, developers should be aware that Tiptap Core is headless by design. This means it does not provide any default UI elements, buttons, or styling. All aspects of the user interface must be built from scratch. This requires a deeper understanding of ProseMirror's underlying architecture and Tiptap's extension system to implement even basic rich text editing functionalities.
When to use
- When building custom UI components for a rich text editor, leveraging Tiptap's declarative extension API.
- When integrating a WYSIWYG editor into a React or Vue application using the `useEditor` hook.
- When needing to extend ProseMirror's capabilities with custom nodes, marks, and commands.
- When implementing collaborative editing features by integrating with ProseMirror's collaboration modules.
- When fine-tuning editor behavior through custom key bindings and input rules.
- When a framework-agnostic editor core is required to fit into diverse front-end architectures.
When NOT to use
- If you require a fully-featured, opinionated rich text editor with pre-built UI elements out-of-the-box, consider a complete editor solution.
- If your application only needs basic text formatting without complex block elements or custom attributes, simpler HTML input elements might suffice.
- If you are unfamiliar with the ProseMirror ecosystem or prefer a high-level abstraction without needing to define editor schemas and extensions.
- If the goal is to rapidly deploy a standard rich text editor with minimal custom UI development, a UI-focused editor package would be more efficient.
- If integrating into a legacy environment where modular JavaScript dependencies are challenging to manage, evaluating the package's bundle size is crucial.