AI Comments

This example shows how to build comments with Liveblocks and Next.js.

Live preview

Open the example above and share it on multiple windows or devices to try it live.

Getting started

Run the following command to try this example locally:

$npx create-liveblocks-app@latest --example nextjs-comments-ai --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 make this example run.

Follow our guide on testing webhooks locally, making sure to check the “commentCreated” event 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 Vercel AI Gateway

You need your own Vercel AI Gateway API key to run the AI agent, which uses Anthropic models through the gateway.

Create an account on Vercel
Create a new API key from the AI Gateway section of the Vercel dashboard
Add your AI Gateway API key to .env.local as the AI_GATEWAY_API_KEY environment variable

Manual setup

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
Follow the "Setting up webooks" and "Setting up OpenAI" sections above.

Deploy on Vercel

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

$npx create-liveblocks-app@latest --example nextjs-comments-ai --vercel

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

Next, follow the "Setting up webooks" and "Setting up OpenAI" sections above.

Develop on CodeSandbox

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

Next, follow the "Setting up webooks" and "Setting up OpenAI" sections above.

AI Comments