Search

Collaboration

VersionDownloads

The Collaboration extension enables you to collaborate with others in a single document. The implementation is based on Y.js by Kevin Jahns, which is the coolest thing to integrate collaborative editing in your project.

The history works totally different in a collaborative editing setup. If you undo a change, you don’t want to undo changes of other users. To handle that behaviour this extension provides an own undo and redo command. Don’t load the default History extension together with the Collaboration extension to avoid conflicts.

Pro Extension

We kindly ask you to sponsor our work when using this extension in production.

Installation

# with npm
npm install @tiptap/extension-collaboration yjs y-websocket

# with Yarn
yarn add @tiptap/extension-collaboration yjs y-websocket

Settings

OptionTypeDefaultDescription
documentObjectnullAn initialized Y.js document.
fieldString'default'Name of a Y.js fragment, can be changed to sync multiple fields with one Y.js document.
fragmentObjectnullA raw Y.js fragment, can be used instead of document and field.

Commands

CommandParametersDescription
undoUndo the last change.
redoRedo the last change.

Keyboard shortcuts

Undo

  • Windows/Linux: Control Z
  • macOS: Cmd Z

Redo

  • Windows/Linux: Shift Control Z or Control Y
  • macOS: Shift Cmd Z or Cmd Y

Source code

packages/extension-collaboration/

Usage

Public

The content of this editor is shared with other users.