GuidesYjs, React, Next.js

How to create a collaborative code editor with Monaco, Yjs, Next.js, and Liveblocks

In this tutorial, we’ll be building a collaborative code editor using Monaco, Yjs, Next.js, and Liveblocks.

This guide assumes that you’re already familiar with React, Next.js, TypeScript, and Monaco.

Install Monaco, Yjs, and Liveblocks into your Next.js application

Download the example

On GitHub we have a working example of this collaborative Monaco editor for you to download and run.

Run the following command to install the Monaco, Yjs, and Liveblocks packages:

Terminal

npm install @liveblocks/client @liveblocks/react @liveblocks/yjs yjs @monaco-editor/react y-monaco y-protocols

Set up access token authentication

The first step in connecting to Liveblocks is to set up an authentication endpoint in /app/api/liveblocks-auth/route.ts.

import { Liveblocks } from "@liveblocks/node";import { NextRequest } from "next/server";
const API_KEY = "";
const liveblocks = new Liveblocks({  secret: API_KEY!,});
export async function POST(request: NextRequest) {  // Get the current user's info from your database  const user = {    id: "charlielayne@example.com",    info: {      name: "Charlie Layne",      color: "#D583F0",      picture: "https://liveblocks.io/avatars/avatar-1.png",    },  };
  // Create a session for the current user  // userInfo is made available in Liveblocks presence hooks, e.g. useOthers  const session = liveblocks.prepareSession(user.id, {    userInfo: user.info,  });
  // Give the user access to the room  const { room } = await request.json();  session.allow(room, ["*:write"]);
  // Authorize the user and return the result  const { body, status } = await session.authorize();  return new Response(body, { status });}

Here’s an example using the older API routes format in /pages.

Initialize your Liveblocks config file

Let’s initialize the liveblocks.config.ts file in which you’ll set up the Liveblocks client.

Terminal

npx create-liveblocks-app@latest --init --framework react

We’ll also need another type for this tutorial. After creating the config file, open it up and insert the following:

liveblocks.config.ts

import { LiveblocksYjsProvider } from "@liveblocks/yjs";
// ...
export type TypedLiveblocksProvider = LiveblocksYjsProvider<  Presence,  Storage,  UserMeta,  RoomEvent>;

Join a Liveblocks room

Liveblocks uses the concept of rooms, separate virtual spaces where people collaborate. To create a realtime experience, multiple users must be connected to the same room. Create a file in the current directory within /app, and name it Room.tsx. Pass the location of your endpoint to LiveblocksProvider.

/app/Room.tsx

"use client";
import { ReactNode } from "react";import {  LiveblocksProvider,  RoomProvider,  ClientSideSuspense,} from "@liveblocks/react/suspense";
export function Room({ children }: { children: ReactNode }) {  return (    <LiveblocksProvider authEndpoint="/api/liveblocks-auth">      <RoomProvider id="my-room">        <ClientSideSuspense fallback={<div>Loading…</div>}>          {children}        </ClientSideSuspense>      </RoomProvider>    </LiveblocksProvider>  );}

Set up the Monaco editor

Now that we’ve set up Liveblocks, we can start integrating Monaco and Yjs in the Editor.tsx file.

Editor.tsx

"use client";
import * as Y from "yjs";import { LiveblocksYjsProvider } from "@liveblocks/yjs";import { TypedLiveblocksProvider, useRoom } from "@/liveblocks.config";import { useCallback, useEffect, useState } from "react";import styles from "./CollaborativeEditor.module.css";import { Editor } from "@monaco-editor/react";import { editor } from "monaco-editor";import { MonacoBinding } from "y-monaco";import { Awareness } from "y-protocols/awareness";
// Collaborative code editor with undo/redo, live cursors, and live avatarsexport function CollaborativeEditor() {  const room = useRoom();  const [provider, setProvider] = useState<TypedLiveblocksProvider>();  const [editorRef, setEditorRef] = useState<editor.IStandaloneCodeEditor>();
  // Set up Liveblocks Yjs provider and attach Monaco editor  useEffect(() => {    let yProvider: TypedLiveblocksProvider;    let yDoc: Y.Doc;    let binding: MonacoBinding;
    if (editorRef) {      yDoc = new Y.Doc();      const yText = yDoc.getText("monaco");      yProvider = new LiveblocksYjsProvider(room, yDoc);      setProvider(yProvider);
      // Attach Yjs to Monaco      binding = new MonacoBinding(        yText,        editorRef.getModel() as editor.ITextModel,        new Set([editorRef]),        yProvider.awareness as Awareness      );    }
    return () => {      yDoc?.destroy();      yProvider?.destroy();      binding?.destroy();    };  }, [editorRef, room]);
  const handleOnMount = useCallback((e: editor.IStandaloneCodeEditor) => {    setEditorRef(e);  }, []);
  return (    <div className={styles.container}>      <div className={styles.editorContainer}>        <Editor          onMount={handleOnMount}          height="100%"          width="100%"          theme="vs-light"          defaultLanguage="typescript"          defaultValue=""          options={{            tabSize: 2,            padding: { top: 20 },          }}        />      </div>    </div>  );}

And here is the Editor.module.css file to make sure your multiplayer text editor looks nice and tidy.

Add your editor to the current page

Next, add the CollaborativeEditor into the page file, and place it inside the Room component we created earlier. We should now be seeing a basic collaborative editor!

/app/page.tsx

import { Room } from "./Room";import CollaborativeEditor from "@/components/Editor";
export default function Page() {  return (    <Room>      <CollaborativeEditor />    </Room>  );}

Add live cursors

To add live cursors to the code editor, we can get the userInfo for the current user with useSelf, and attach it Yjs awareness. Currently, the only way to style this is to loop through each Yjs user, and dynamically insert CSS styles into the page, using ::after to display users’ names. We’ll place this in a new file:

Cursors.tsx

import { useEffect, useMemo, useState } from "react";import {  AwarenessList,  TypedLiveblocksProvider,  UserAwareness,  useSelf,} from "@/liveblocks.config";
type Props = {  yProvider: TypedLiveblocksProvider;};
export function Cursors({ yProvider }: Props) {  // Get user info from Liveblocks authentication endpoint  const userInfo = useSelf((me) => me.info);
  const [awarenessUsers, setAwarenessUsers] = useState<AwarenessList>([]);
  useEffect(() => {    // Add user info to Yjs awareness    const localUser: UserAwareness["user"] = userInfo;    yProvider.awareness.setLocalStateField("user", localUser);
    // On changes, update `awarenessUsers`    function setUsers() {      setAwarenessUsers([...yProvider.awareness.getStates()] as AwarenessList);    }    yProvider.awareness.on("change", setUsers);    setUsers();
    return () => {      yProvider.awareness.off("change", setUsers);    };  }, [yProvider]);
  // Insert awareness info into cursors with styles  const styleSheet = useMemo(() => {    let cursorStyles = "";
    for (const [clientId, client] of awarenessUsers) {      if (client?.user) {        cursorStyles += `          .yRemoteSelection-${clientId},          .yRemoteSelectionHead-${clientId}  {            --user-color: ${client.user.color};          }
          .yRemoteSelectionHead-${clientId}::after {            content: "${client.user.name}";          }        `;      }    }
    return { __html: cursorStyles };  }, [awarenessUsers]);
  return <style dangerouslySetInnerHTML={styleSheet} />;}

This CSS will work in combination with some other styles, which we can place in a global CSS file:

You can then import this into your editor to enable live cursors:

Editor.tsx

import { Cursors } from "@/components/Cursors";// ...
export function CollaborativeEditor() {  // ...
  return (    <div className={styles.container}>      {provider ? <Cursors yProvider={provider} /> : null}      <div className={styles.editorContainer}>        <Editor          onMount={handleOnMount}          height="100%"          width="100%"          theme="vs-light"          defaultLanguage="typescript"          defaultValue=""          options={{            tabSize: 2,            padding: { top: 20 },          }}        />      </div>    </div>  );}

Add a toolbar

From this point onwards, you can build your Monaco app as normal! For example, should you wish to add a basic undo/redo toolbar to your app:

Toolbar.tsx

import styles from "./Toolbar.module.css";import { editor } from "monaco-editor";
type Props = {  editor: editor.IStandaloneCodeEditor;};
export function Toolbar({ editor }: Props) {  return (    <div className={styles.toolbar}>      <button        className={styles.button}        onClick={() => editor.trigger("", "undo", null)}      >        Undo      </button>      <button        className={styles.button}        onClick={() => editor.trigger("", "redo", null)}      >        Redo      </button>    </div>  );}

Add some matching styles:

You can then import this into your editor to enable basic Monaco features:

Editor.tsx

import { Toolbar } from "@/components/Toolbar";// ...
export function CollaborativeEditor() {  // ...
  return (    <div className={styles.container}>      {provider ? <Cursors yProvider={provider} /> : null}      <div className={styles.editorHeader}>        <div>{editorRef ? <Toolbar editor={editorRef} /> : null}</div>      </div>      <div className={styles.editorContainer}>        <Editor          onMount={handleOnMount}          height="100%"          width="100%"          theme="vs-light"          defaultLanguage="typescript"          defaultValue=""          options={{            tabSize: 2,            padding: { top: 20 },          }}        />      </div>    </div>  );}

Create live avatars with Liveblocks hooks

Along with building out your code editor, you can now use other Liveblocks features, such as presence. The useOthers hook allows us to view information about each user currently online, and we can turn this into a live avatars component.

Avatars.tsx

import { useOthers, useSelf } from "@/liveblocks.config";import styles from "./Avatars.module.css";
export function Avatars() {  const users = useOthers();  const currentUser = useSelf();
  return (    <div className={styles.avatars}>      {users.map(({ connectionId, info }) => {        return (          <Avatar key={connectionId} picture={info.picture} name={info.name} />        );      })}
      {currentUser && (        <div className="relative ml-8 first:ml-0">          <Avatar            picture={currentUser.info.picture}            name={currentUser.info.name}          />        </div>      )}    </div>  );}
export function Avatar({ picture, name }: { picture: string; name: string }) {  return (    <div className={styles.avatar} data-tooltip={name}>      <img        src={picture}        className={styles.avatar_picture}        data-tooltip={name}      />    </div>  );}

And here’s the styles:

You can then import this to your editor to see it in action:

Editor.tsx

import { Avatars } from "@/components/Avatars";// ...
export function CollaborativeEditor() {  // ...
  return (    <div className={styles.container}>      {provider ? <Cursors yProvider={provider} /> : null}      <div className={styles.editorHeader}>        <div>{editorRef ? <Toolbar editor={editorRef} /> : null}</div>        <Avatars />      </div>      <div className={styles.editorContainer}>        <Editor          onMount={handleOnMount}          height="100%"          width="100%"          theme="vs-light"          defaultLanguage="typescript"          defaultValue=""          options={{            tabSize: 2,            padding: { top: 20 },          }}        />      </div>    </div>  );}

Note that the cursors and avatars match in color and name, as the info for both is sourced from the Liveblocks authentication endpoint.

Try it out

You should now see the complete editor, along with live cursors, live avatars, and some basic features! On GitHub we have a working example of this multiplayer code editor.

How to create a collaborative code editor with Monaco, Yjs, Next.js, and Liveblocks

Install Monaco, Yjs, and Liveblocks into your Next.js application

Set up access token authentication

Initialize your Liveblocks config file

Join a Liveblocks room

Set up the Monaco editor

Add your editor to the current page

Add live cursors

Add a toolbar

Create live avatars with Liveblocks hooks

Try it out

Tiptap best practices and tips

How to add users to Liveblocks Text Editor

How to create a collaborative code editor with Monaco, Yjs, Next.js, and Liveblocks

Related guides

Tiptap best practices and tips

How to add users to Liveblocks Text Editor