yjs

A CRDT framework with a powerful abstraction of shared data

Yjs is a CRDT implementation that exposes its internal data structure as shared types. Shared types are common data types like Map or Array with superpowers: changes are automatically distributed to other peers and merged without merge conflicts.

Yjs is network agnostic (p2p!), supports many existing rich text editors, offline editing, version snapshots, undo/redo and shared cursors. It scales well with an unlimited number of users and is well suited for even large documents.

• Demos: https://github.com/yjs/yjs-demos
• Discuss: https://discuss.yjs.dev
• Chat: Gitter | Discord
• Benchmark Yjs vs. Automerge: https://github.com/dmonad/crdt-benchmarks
• Podcast "Yjs Deep Dive into real time collaborative editing solutions":
• Podcast "Google Docs-style editing in Gutenberg with the YJS framework":

:construction_worker_woman: If you are looking for professional support, please consider supporting this project via a "support contract" on GitHub Sponsors. I will attend your issues quicker and we can discuss questions and problems in regular video conferences. Otherwise you can find help on our community discussion board.

Sponsorship

Please contribute to the project financially - especially if your company relies on Yjs.

Professional Support

• Support Contract with the Maintainer - By contributing financially to the open-source Yjs project, you can receive professional support directly from the author. This includes the opportunity for weekly video calls to discuss your specific challenges.
• Synergy Codes - Specializing in consulting and developing real-time collaborative editing solutions for visual apps, Synergy Codes focuses on interactive diagrams, complex graphs, charts, and various data visualization types. Their expertise empowers developers to build engaging and interactive visual experiences leveraging the power of Yjs. See their work in action at Visual Collaboration Showcase.

Who is using Yjs

• AFFiNE A local-first, privacy-first, open source knowledge base. :star2:
• Cargo Site builder for designers and artists :star2:
• Gitbook Knowledge management for technical teams :star2:
• Evernote Note-taking app :star2:
• Lessonspace Enterprise platform for virtual classrooms and online training :star2:
• Ellipsus - Collaborative writing app for storytelling etc. Supports versioning, change attribution, and "blame". A solution for the whole publishing process (also selling) :star:
• Dynaboard Build web apps collaboratively. :star:
• Relm A collaborative gameworld for teamwork and community. :star:
• Huly - Open Source All-in-One Project Management Platform
• Room.sh A meeting application with integrated collaborative drawing, editing, and coding tools. :star:
• Nimbus Note A note-taking app designed by Nimbus Web. :star:
• Pluxbox RadioManager A web-based app to collaboratively organize radio broadcasts. :star:
• modyfi - Modyfi is the design platform built for multidisciplinary designers. Design, generate, animate, and more — without switching between apps. :star:
• Sana A learning platform with collaborative text editing powered by Yjs.
• Serenity Notes End-to-end encrypted collaborative notes app.
• PRSM Collaborative mind-mapping and system visualisation. (source)
• Alldone A next-gen project management and collaboration platform.
• Living Spec A modern way for product teams to collaborate.
• Slidebeamer Presentation app.
• BlockSurvey End-to-end encryption for your forms/surveys.
• Skiff Private, decentralized workspace.
• JupyterLab Collaborative computational Notebooks
• JupyterCad Extension to JupyterLab that enables collaborative editing of 3d FreeCAD Models.
• JupyterGIS Collaborative GIS (Geographic Information System) editor in Jupyter
• Hyperquery A collaborative data workspace for sharing analyses, documentation, spreadsheets, and dashboards.
• Nosgestesclimat The french carbon footprint calculator has a group P2P mode based on yjs
• SupaKit Spaces for every idea, task, or project.
• LegendKeeper Collaborative campaign planner and worldbuilding app for tabletop RPGs.
• IllumiDesk Build courses and content with A.I.
• btw Open-source Medium alternative
• AWS SageMaker Tools for building Machine Learning Models
• linear Streamline issues, projects, and product roadmaps.
• Arkiter - Live interview software
• Appflowy - They use Yrs
• Multi.app - Multiplayer app sharing: Point, draw and edit in shared apps as if they're on your computer. They are using Yrs.
• AppMaster A No-Code platform for creating production-ready applications with source code generation.
• Synthesia - Collaborative Video Editor
• thinkdeli - A fast and simple notes app powered by AI
• ourboard - A collaborative whiteboard application
• Ellie.ai - Data Product Design and Collaboration
• GoPeer - Collaborative tutoring
• screen.garden - Collaborative backend for PKM apps.
• NextCloud - Content Collaboration Platform
• keystatic - git-based CMS
• QDAcity - Collaborative qualitative data analysis platform
• Kanbert - Project management software
• Eclipse Theia - A cloud & desktop IDE that runs in the browser.
• ScienHub - Collaborative LaTeX editor in the browser.
• Open Collaboration Tools - Collaborative editing for your IDE or custom editor
• Typst - Compose, edit, and automate technical documents
• Kedyou - Digital workspaces for tutoring
• Lightpage - Personal living notebook
• reearth-flow - Collaboratively calculate and convert various data
• ProtonMail | Proton Docs - E2E encrypted collaborative documents in Proton Drive.
• Theneo - AI-powered API docs with live team collaboration.
• ToolJet - Build full-stack enterprise internal apps in minutes.

Table of Contents

• Overview
  • Bindings
  • Providers
  • Tooling
  • Ports
• Getting Started
• API
  • Shared Types
  • Y.Doc
  • Document Updates
  • Relative Positions
  • Y.UndoManager
• Yjs CRDT Algorithm
• License and Author

Overview

This repository contains a collection of shared types that can be observed for changes and manipulated concurrently. Network functionality and two-way-bindings are implemented in separate modules.

Bindings

Name Cursors Binding Demo ProseMirror                                                   ✔ y-prosemirror demo Quill ✔ y-quill demo CodeMirror ✔ y-codemirror demo Monaco ✔ y-monaco demo Ace ✔ y-ace Slate ✔ slate-yjs demo BlockSuite ✔ (native) demo Lexical ✔ (native) demo BlockNote ✔ y-prosemirror demo Tiptap ✔ y-prosemirror demo Milkdown ✔ y-prosemirror demo Superdoc ✔ (native) demo valtio valtio-yjs demo immer immer-yjs demo mutative mutative-yjs demo React react-yjs demo React / Vue / Svelte / MobX SyncedStore demo mobx-keystone mobx-keystone-yjs demo PSPDFKit yjs-pspdfkit demo Rows n'Columns ✔ @rowsncolumns/y-spreadsheet

Utilities

Tools that extend the core functionality of Yjs.

y-uti