<BlogPostCustomerFacts
  logo="/images/companies/logos/artefact.svg"
  name="Artefect"
  urlWebsite="https://www.tryartefact.com"
  teamSize={4}
  yearFounded={2024}
  customerSinceDate={new Date(2025, 3, 1)}
/>

## Challenge

Artefact provides a shared workspace for teams to create, review, and approve
technical documents effortlessly. Its powerful tools help clarify collaboration,
automate approvals, and keep technical teams aligned, so they can focus on
shipping, not guessing.

Technical documentation is essential–but creating it in enterprise environments
is notoriously difficult. Product and engineering teams spend countless hours
shaping requirements and specifications, only to hit familiar
bottlenecks—securing clear and timely approvals from cross-functional
stakeholders.

Artefact recognized that traditional approval methods, like dropdown menus and
cluttered version histories, simply weren’t cutting it. They left teams unsure
about who approved what, and when, resulting in delays and confusion. For this
reason, they built something better, a dedicated, collaborative workspace
tailored specifically to the way technical teams create, review, and approve
docs.

<Figure>
  <Image
    src="/images/blog/artefact/approving.gif"
    alt="An approval taking place in Artefact"
    width={768}
    height={512}
    quality={80}
  />
</Figure>

## Solution

Artefact partnered with Liveblocks to build a dynamic documentation workspace
that reimagines how product and engineering teams collaborate. The team
implemented a number of key collaborative features, powered by Liveblocks.

### Presence indicators

Using presence avatars, team members can see who is currently viewing and
editing a document in realtime, providing instant visibility into team
activities.

<Figure
  caption={
    <>
      Live avatar stack created with{" "}
      <Link href="/presence">Liveblocks Presence</Link>
    </>
  }
>
  <Image
    src="/images/blog/artefact/presence.png"
    alt="Presence"
    width={768}
    height={512}
    quality={80}
  />
</Figure>

### Collaborative editing

Artefact’s collaborative document editing allows teams to work together in
realtime, creating rich-text documents together. You can add use mentions,
headings, comments, tables, and more, using an interactive toolbar. Live cursors
are displayed for each user as they select text and write.

<Figure
  caption={
    <>
      Powered by <Link href="/text-editor">Liveblocks Text Editor</Link> and{" "}
      <Link href="/docs/api-reference/liveblocks-react-tiptap">Tiptap</Link>
    </>
  }
>
  <Image
    src="/images/blog/artefact/text-editor.png"
    alt="Collaborative editing"
    width={768}
    height={512}
    quality={80}
  />
</Figure>

### Templates

Artefact provides a set of templates to start from, you can click the _Create
Document_ button to insert a ready-made template into the editor.

<Figure
  caption={
    <>
      Our{" "}
      <Link href="/docs/api-reference/liveblocks-node-prosemirror">
        Node.js package
      </Link>{" "}
      enables inserting content into editors
    </>
  }
>
  <Image
    src="/images/blog/artefact/templates.png"
    alt="Templates"
    width={768}
    height={512}
    quality={80}
  />
</Figure>

### Floating toolbar

Within the text editor, you can select text and use the toolbar to style your
text, use blockquotes, add comments, and more.

<Figure
  caption={
    <>
      This is our pre-built{" "}
      <Link href="/docs/api-reference/liveblocks-react-tiptap#FloatingToolbar">
        FloatingToolbar
      </Link>{" "}
      component
    </>
  }
>
  <Image
    src="/images/blog/artefact/text-editor-toolbar.png"
    alt="ArtefactAI"
    width={768}
    height={512}
    quality={80}
  />
</Figure>

### AI toolbar

If you click the _ArtefactAI_ button in the toolbar, you can apply AI
suggestions for the current selection, and make changes. For example, you can
ask the AI to improve the quality of your writing, or translate text into a
different language.

<Figure
  caption={
    <>
      AI powered by <Link href="/ai-copilots">Liveblocks AI Copilots</Link> and
      our pre-built{" "}
      <Link href="/docs/api-reference/liveblocks-react-tiptap#AiToolbar">
        AiToolbar
      </Link>{" "}
      component
    </>
  }
>
  <Image
    src="/images/blog/artefact/text-editor-ai.png"
    alt="ArtefactAI"
    width={768}
    height={512}
    quality={80}
  />
</Figure>

### Comments

Within the text editor, you can add comment threads to a document. These threads
are displayed in a sidebar, anchored to the right of the text editor, and you
can tag others, upload attachments, add emoji reactions, and more.

<Figure
  caption={
    <>
      Uses <Link href="/comments">Liveblocks Comments</Link> and our pre-built{" "}
      <Link href="/docs/api-reference/liveblocks-react-tiptap#AnchoredThreads">
        AnchoredThreads
      </Link>{" "}
      component
    </>
  }
>
  <Image
    src="/images/blog/artefact/anchored-comments.png"
    alt="Comments"
    width={768}
    height={512}
    quality={80}
  />
</Figure>

In an alternate display mode, they’re also rendered as floating comments under
the highlighted piece of text.

<Figure
  caption={
    <>
      Uses our pre-built{" "}
      <Link href="/docs/api-reference/liveblocks-react-tiptap#FloatingThreads">
        FloatingThreads
      </Link>{" "}
      component
    </>
  }
>
  <Image
    src="/images/blog/artefact/floating-comments.png"
    alt="Floating comments"
    width={768}
    height={512}
    quality={80}
  />
</Figure>

### Approvals

Each document can be assigned certain reviewers, who have permission to read and
approve the document. Reviewers are listed in the sidebar with their current
approval status, and documents also have different statuses: _Drafting_, _In
Review_, and _Approved_.

<Figure
  caption={
    <>
      Reviewers and approvals are stored in our{" "}
      <Link href="/sync-datastore">realtime sync engine</Link>
    </>
  }
>
  <Image
    src="/images/blog/artefact/approvals.png"
    alt="Approvals"
    width={768}
    height={512}
    quality={80}
  />
</Figure>

### Share menu

The in-app share menu allows editors to invite new users to the document. Users
can be assigned full edit access, or just read-only access.

<Figure
  caption={
    <>
      We have a similar share menu in our{" "}
      <Link href="/nextjs-starter-kit">Next.js Starter Kit</Link>
    </>
  }
>
  <Image
    src="/images/blog/artefact/share-menu.png"
    alt="Share menu"
    width={768}
    height={512}
    quality={80}
  />
</Figure>

### Inbox notifications

When a user is mentioned in a document, or if a new comment is added to as
thread they’re participating in, they receive a notification in their inbox.
Inbox notifications can be marked as read or deleted.

<Figure
  caption={
    <>
      Created with our pre-built{" "}
      <Link href="/notifications">Liveblocks Notifications</Link> components
    </>
  }
>
  <Image
    src="/images/blog/artefact/notifications.png"
    alt="Notifications"
    width={768}
    height={512}
    quality={80}
  />
</Figure>

### Email notifications

If a user misses an inbox notification, Artefact sends an email notification to
the user, letting them know. Users can configure which types of notifications
they’d like to receive, for example mentions in the text editor, tags in
comments, etc.

<Figure
  caption={
    <>
      Built with our{" "}
      <Link href="/docs/api-reference/liveblocks-emails">email package</Link>,{" "}
      <Link href="/docs/guides/how-to-create-a-notification-settings-panel">
        webhooks
      </Link>{" "}
      and{" "}
      <Link href="/examples/collaborative-text-editor-emails">
        email templates
      </Link>
    </>
  }
>
  <Image
    src="/images/blog/artefact/email.png"
    alt="Notifications"
    width={768}
    height={512}
    quality={80}
  />
</Figure>

## Results

With these features working seamlessly together,
[Artefact](https://tryartefact.com) has truly reinvented what a collaborative
workspace can be for technical teams. Instead of stitching together fragmented
tools, they built a unified environment where realtime editing, AI assistance,
and contextual feedback come together—making documentation not just easier to
produce, but genuinely collaborative from start to finish.

If you’d like to build similar features into your product, make sure to check
out our [examples gallery](/examples) where highlight how to implement every
part of this. Additionally our [Next.js Starter Kit](/nextjs-starter-kit)
contains the features listed above in a single project, and you can even try out
a [live demo](https://nextjs-starter-kit.liveblocks.app).