Getting started
Run the example
Launch the included Next.js and Convex chat application locally.
The example demonstrates direct and group conversations, unread state, replies, edits, reactions, image and voice attachments, online presence, and typing indicators.
Requirements
- Node.js 20 or newer
- pnpm 10
- A Convex account and development deployment
Start Convex
pnpm install
pnpm --filter convex-chat build:codegen
pnpm convex:devStart Next.js
In a second terminal:
pnpm dev:exampleOpen http://localhost:3001. Convex writes the ignored deployment settings to apps/example/.env.local.
Demo identity only
The Alice, Bob, and Charlie switcher is intentionally insecure. Production applications must derive identity in authenticated host functions.