convex-chat
Authorization-aware direct and small-group chat primitives for Convex applications.
convex-chat is an independent Convex component for human messaging. It owns durable chat invariants—membership, ordering, idempotency, unread state, message lifecycle, and presence—while your application owns authentication, relationships, and product policy.
Early alpha
The API and data model may change before the first stable release. The package
latest tag currently points to the 0.0.1 name-reservation placeholder;
install the implementation with convex-chat@next.
What it provides
- Direct and small-group conversations
- Chat-local membership checks on actor operations
- Ordered, idempotent messages and exact unread counts
- Replies, revision-safe edits, tombstones, and reactions
- Online presence and typing indicators
- Provider-neutral attachment descriptors
Start here
Install the component
Register convex-chat and expose actor-scoped host functions.
Run the example
Try realtime conversations, attachments, voice messages, and presence.
Understand the boundary
See what belongs to your app and what belongs to the component.
Review the roadmap
Separate supported behavior from modeled groundwork and future priorities.