Real-time collaboration

SuperDoc v2 can synchronize one DOCX through a y-websocket, Hocuspocus, or Liveblocks provider. The browser editor owns the provider and Y.Doc lifecycle after your application supplies a v2Collaboration target on the document.

Use roomMode: 'create' once to seed a missing room from the document's data. Later clients use roomMode: 'join' with the same documentId:

const document = {
  id: 'shared-document',
  type: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
  data: docxBlob,
  v2Collaboration: {
    providerType: 'hocuspocus',
    documentId: 'contract-123',
    serverUrl: 'wss://collaboration.example.com',
    roomMode: 'join',
  },
};

Wait for onCollaborationReady before enabling document-dependent controls. Call destroy() when the editor unmounts so SuperDoc releases its owned connection.

The collaboration example provides a complete local setup with an in-memory Hocuspocus server and two synchronized browser pages. Authentication and persistence belong in server hooks and are intentionally outside that first example.