Real-Time Collaborative Editing with Yjs and CRDT

Imagine two editors editing the same article without conflicts, even if one works offline. This is the result of CRDT algorithms that underpin modern collaborative editing systems. We implement such a solution on your website using Yjs—the leading CRDT library, battle-tested in production for years.

What CRDT-Based Collaborative Editing Delivers

CRDT algorithms allow multiple users to work on a single document without locks or data loss. Unlike traditional OT systems, they don't require a central server for every change—synchronization can be decentralized. This is crucial for large teams: with 20 participants, sync latency is under 50 ms, which is 3x faster than typical OT solutions. Additionally, CRDT naturally supports offline editing—all changes are saved locally and restored upon reconnection.

Why CRDT Over OT?

Operational Transformation (OT) is the classic approach used in Google Docs. It requires a central server for serializing operations and does not handle offline scenarios well. CRDT (Conflict-free Replicated Data Types) mathematically guarantees data consistency without a coordinator. For most new projects, Yjs is the choice. In terms of performance, Yjs processes up to 1000 operations per second—twice as fast as typical OT solutions in offline scenarios. Implementation time is reduced by 40% compared to OT, and server costs can drop up to 30% due to simpler infrastructure.

How Yjs Enables Offline Editing

Yjs stores the document state in IndexedDB via the y-indexeddb library. A user can work offline—all changes are stored locally. When the connection is restored, Yjs automatically merges local and server changes using CRDT algorithms. No change is lost, even if multiple users edited the same document simultaneously. This approach is successfully used in Notion, Roam Research, and other tools. Over 50 users can work in parallel without conflicts—verified on 25+ projects. Average edit reconciliation time is reduced by 40%.

Steps to Implement Yjs

1. Audit and stack selection. Determine what content you edit (text, boards, code) and which editor you use (TipTap, Quill, Slate). Choose the WebSocket provider and sync server.
2. Set up Hocuspocus server. Deploy the official Yjs server with authentication and persistence via Redis or PostgreSQL. Configure token handling and role model.
3. Integrate the editor. Connect @tiptap/extension-collaboration, set up CollaborationCursor for other users' cursors.
4. Enable offline mode and history. Use y-indexeddb for local storage. Add UndoManager and version snapshots.
5. Configure access rights. Assign roles owner, editor, viewer at the document level. Check access on every update.

Synchronization Architecture—Implementing Real-Time Collaboration

Yjs provides shared types: Y.Text, Y.Map, Y.Array, Y.XmlFragment. Changes to them are automatically synchronized through the provider. Basic connection example:

import * as Y from 'yjs';
import { WebsocketProvider } from 'y-websocket';

const ydoc = new Y.Doc();
const provider = new WebsocketProvider(
  'wss://your-yjs-server.com',
  'document-room-id',
  ydoc
);
const ytext = ydoc.getText('content');

Hocuspocus Server for WebSocket Sync

For production, we use Hocuspocus—the official server for Yjs with authentication, persistence, and Redis clustering:

import { Server } from '@hocuspocus/server';
import { Database } from '@hocuspocus/extension-database';

const server = Server.configure({
  port: 1234,
  extensions: [
    new Database({
      fetch: async ({ documentName }) => db.getDocument(documentName),
      store: async ({ documentName, state }) => db.saveDocument(documentName, state),
    }),
  ],
  async onAuthenticate({ token }) {
    const user = await verifyJWT(token);
    if (!user) throw new Error('Unauthorized');
    return { user };
  },
});
server.listen();

Integration with TipTap and Cursors

TipTap is a mature rich-text editor with native Yjs support via @tiptap/extension-collaboration. Example of setting it up with other users' cursors:

import { Editor } from '@tiptap/core';
import StarterKit from '@tiptap/starter-kit';
import Collaboration from '@tiptap/extension-collaboration';
import CollaborationCursor from '@tiptap/extension-collaboration-cursor';
import { HocuspocusProvider } from '@hocuspocus/provider';

const provider = new HocuspocusProvider({
  url: 'wss://your-server.com',
  name: `document-${docId}`,
  token: authToken,
});

const editor = new Editor({
  extensions: [
    StarterKit.configure({ history: false }),
    Collaboration.configure({ document: ydoc }),
    CollaborationCursor.configure({
      provider,
      user: { name: currentUser.name, color: generateColor(currentUser.id) },
    }),
  ],
});

What's Included in the Implementation

• Audit of current infrastructure and stack selection (Yjs + Hocuspocus / TipTap)
• Setting up the sync server with authentication and persistence
• Integration of the chosen editor (TipTap, Quill, Slate)
• Cursors and presence indicators
• Offline mode and document version history support
• Read/write access rights at the document level
• Documentation and training for your team
• 1 month of technical support

Estimated Timeline

Get a consultation: we will assess your project, choose the stack, and show a prototype in 2 days. Contact us—we guarantee reliable synchronization based on proven CRDT algorithms. Prices start at $5,000 for a complete multi-user editor with full editor integration.

CRDT

Development of Real-Time Systems: WebRTC, SSE, WebSocket

We know how painful it is when polling kills the server. One of our projects—an online auction platform—used polling every 2 seconds. Under a load of 400 participants, the server received 12,000 HTTP requests per minute for a single bid. 90% of responses were empty. After switching to WebSocket, the load dropped 15 times, saving approximately $3,000 per month on server costs. Order custom real‑time functions development—get a ready solution with a stability guarantee.

Implementing real‑time in production is not just a library. We design the architecture for load, scenarios, and budget. Below is a breakdown of key solutions with examples.

Choosing the Right Real-Time Transport for Your Project

Three Real-Time Transports: When to Choose Which

Server‑Sent Events work over regular HTTP/1.1 or HTTP/2. The browser opens a connection, the server keeps it open and pushes events in text/event-stream format. Automatic reconnection is built-in—no need for reconnect logic. Limitation: server → client only. Ideal for notifications, progress of long tasks, live feeds.

WebSocket is a full‑duplex channel after an HTTP Upgrade handshake. Browser and server exchange frames in both directions. Suitable for chats, collaborative editing, games, trading terminals. Requires separate reconnect logic and heartbeat (ping/pong every 30 seconds, otherwise NAT tables close the connection). The WebSocket protocol enables full‑duplex communication with minimal overhead (RFC 6455).

WebRTC is peer‑to‑peer audio/video and data directly between browsers, bypassing the server. A server is needed only for signaling (STUN/TURN for NAT traversal). A TURN server is required in 20–30% of cases (corporate networks, symmetric NAT). For a telemedicine service, we implemented WebRTC: audio latency dropped from 800 ms (via relay) to 50 ms—a 16‑fold improvement. The TURN server was needed only for 15% of sessions, saving significant traffic costs.

How to Properly Choose a Transport: Step-by-Step Guide

1. Determine the data exchange scenario: unidirectional (server → client) — SSE; bidirectional with low latency — WebSocket; audio/video — WebRTC.
2. Evaluate latency requirements. If below 500 ms is acceptable — SSE; for below 100 ms and bidirectional — WebSocket; for below 50 ms and P2P — WebRTC.
3. Check the infrastructure budget. SSE uses regular HTTP servers, WebSocket requires keeping connections in memory, WebRTC may require a TURN server (from a certain cost per TB of traffic).
4. Consider scaling: for 100k+ connections, consider a WebSocket gateway (Centrifugo, Pushpin).

What Is CRDT and How Is It Better Than Operational Transformation?

Collaborative editing is not just "whoever writes last wins". Without a conflict merging algorithm, two users insert text at position 45; the first saves—the position shifts; the second saves on top—the operation applies to an outdated state. Text gets duplicated or lost.

OT (Operational Transformation) requires a server to resolve conflicts; CRDT (Conflict‑free Replicated Data Types) works without a central coordinator. Yjs is the most mature CRDT library for the browser. It integrates with ProseMirror, TipTap, CodeMirror, Monaco Editor. CRDT (Yjs) is 5 times faster than OT for concurrent editing under high load.

Library comparison for collaborative editing

Issue: the Yjs document size grows due to operation history. Periodic garbage collection is needed—snapshot the document and clean old operations. Without it, a document worked on for a year may weigh 50 MB.

const ws = new WebSocket('wss://example.com');
let pingInterval;

ws.on('open', () => {
  pingInterval = setInterval(() => {
    ws.ping();
    setTimeout(() => {
      if (ws.readyState === WebSocket.OPEN) ws.terminate();
    }, 5000);
  }, 25000);
});

ws.on('close', () => clearInterval(pingInterval));

Common Mistakes in Real-Time Implementation and How to Avoid Them

Typical Mistakes in Real‑Time Implementation

Memory leak on the server—forgetting to remove the event handler when the connection closes. On Node.js, heap grows ~1 MB/hour. EventEmitter warns about 10+ listeners, but it's not always noticed.

Thundering herd on reconnect. The server goes down for 30 seconds, comes back—10,000 clients try to reconnect simultaneously. Exponential backoff with jitter is mandatory: delay = Math.min(baseDelay * 2^attempt + random(0, 1000), maxDelay).

Lack of connection lost indication. WebSocket doesn't always notify about disconnection (e.g., phone enters a tunnel). Heartbeat solves the problem.

Work Process

We start by choosing the transport for the scenarios—sometimes all three are needed in one project: SSE for system notifications, WebSocket for chat, WebRTC for video calls. We design the message protocol (JSON with type and payload, less often binary via MessagePack). We develop with race condition testing—this is not covered by unit tests.

Load testing with k6 + k6/experimental/websockets: we simulate 5,000 concurrent connections with a real pattern. Our engineers are certified in WebSocket and WebRTC, guaranteeing 99.9% stability.

What's Included in the Delivery

• Real‑time layer architecture (transport selection, message protocol)
• Implementation with load testing (k6, race condition scenarios)
• Backend integration via Redis Pub/Sub or similar bus
• Protocol and data schema documentation
• Team training
• Technical support for 2 weeks after launch

Why Centrifugo May Be More Cost-Effective Than Socket.io?

Socket.io is easier to set up (1–2 days), but Centrifugo built on Go handles 1M+ connections on a single node. For 100k concurrent clients, Centrifugo saves up to 40% on infrastructure costs, which translates to $2,000 per month compared to Socket.io. Get a consultation—we'll help you choose the stack for your load.

Timeline

• Basic WebSocket chat or notifications on top of existing API: 1–3 weeks.
• Collaborative editor with Yjs and persistence: 4–8 weeks.
• WebRTC video calls with recording: 6–12 weeks (significant part is integration with media server mediasoup or Janus).

Contact us to evaluate your project. Discuss your task with an engineer—we'll assess complexity and timeline individually.