New Project

Liveblocks Linear-like Issue Tracker

A Linear-like collaborative issue tracker using Liveblocks and Next.js.

DeployView Demo

Linear-like Issue Tracker

This example shows how to build a Linear-inspired collaborative issue tracker using Liveblocks, and Next.js. Users can create issues with a rich-text editor, giving them priorities, progress state, and labels. Comments can be left on issues and users receive notifications if they've been mentioned.

You can optionally enable an AI assistant that you can mention it comments and will stream in replies. The assistant can create new issues, and edit the current issue, showing AI presence as it works.

Getting started

Run the following command to try this example locally:

npx create-liveblocks-app@latest --example nextjs-linear-like-issue-tracker --api-key

This will download the example and ask permission to open your browser, enabling you to automatically get your API key from your liveblocks.io account.

Setting up webhooks

You need to set up webhooks to use all features in this example.

  • Follow our guide on testing webhooks locally, making sure to check the “commentCreated” and “storageUpdated” events when creating the webhook
  • In the webhooks dashboard, point to the /api/liveblocks-webhook path
  • Copy your webhook secret key from the webhooks dashboard
  • Add your webhook secret key to .env.local as the LIVEBLOCKS_WEBHOOK_SECRET_KEY environment variable

Setting up Anthropic

You need your own Anthropic API key to run the AI agent.

  • Create an account on Anthropic
  • Create a new API key from the Anthropic Dashboard
  • Add your Anthropic API key to .env.local as the ANTHROPIC_API_KEY environment variable

Manual setup

Read more

Alternatively, you can set up your project manually:

  • Install all dependencies with npm install
  • Create an account on liveblocks.io
  • Copy your secret key from the dashboard
  • Create an .env.local file and add your secret key as the LIVEBLOCKS_SECRET_KEY environment variable
  • Run npm run dev and go to http://localhost:3000

Dev server setup

Read more

You can optionally run this example locally using the Liveblocks dev server.

  • Install the example as detailed above
  • Run npx liveblocks dev to start the server
  • Add baseUrl: "http://localhost:1153" option to LiveblocksProvider and new Liveblocks
  • Replace secret in new Liveblocks with "sk_localdev"
  • Run npm run dev and go to http://localhost:3000

Deploy on Vercel

Read more

To both deploy on Vercel, and run the example locally, use the following command:

npx create-liveblocks-app@latest --example nextjs-linear-like-issue-tracker --vercel

This will download the example and ask permission to open your browser, enabling you to deploy to Vercel.

Develop on CodeSandbox

Read more

After forking this example on CodeSandbox, create the LIVEBLOCKS_SECRET_KEY environment variable as a secret.

GitHub Repoliveblocks/liveblocks
LicenseView License
Use Cases
Realtime Apps
Stack
Next.js
Tailwind
Database
Liveblocks

Related Templates

Platforms Starter Kit

Next.js template for building multi-tenant applications with the App Router and Redis.
Platforms Starter Kit thumbnail

Liveblocks Tldraw Whiteboard

A collaborative tldraw-like whiteboard built with Liveblocks Storage and Next.js.
Liveblocks Tldraw Whiteboard thumbnail

Liveblocks Notion-like AI Editor

A Notion-like collaborative text editor with AI features built with Liveblocks, Lexical, Vercel AI SDK, and Next.js.
Liveblocks Notion-like AI Editor thumbnail
DeployView Demo