Hocuspocus

The official server for Yjs, providing easy-to-deploy WebSocket endpoints for syncing Yjs documents.

Overview

Hocuspocus is a Node.js server that works seamlessly with Yjs clients. It provides middleware for authentication, persistence, and broadcasting. It is designed to be deployed anywhere (Vercel, Lambda, Docker) and handles the complexities of Yjs document syncing. It is the recommended way to run Yjs in production, especially for serverless environments.

Best for

• Yjs document syncing
• Serverless collaboration backends
• Custom awareness data handling

Trade-offs

What XeroHack pre-wires

When you pick Hocuspocus in the interview, the engine emits these files into your scaffold:

• Hocuspocus server setup
• OnBroadcast hook
• OnConnect middleware