At a Glance:
Cossistant is an open source chat support widget for the React ecosystem, providing headless components, real-time messaging, and a complete API-driven backend infrastructure through dedicated React and Next.js SDKs.
Overview:
Cossistant is an open source chat support widget designed specifically for the React ecosystem. It gives developers a set of headless hooks and primitives through the @cossistant/react package, alongside Next.js-specific utilities via @cossistant/next. The project follows a code-first, API-driven philosophy and ships with a full backend infrastructure. Real-time messaging is built in, and the entire system is structured as a monorepo managed with Turborepo. The backend relies on Hono for the API layer, tRPC for end-to-end typesafe communication, Drizzle ORM, Better Auth for authentication, WebSockets for live updates, and a Docker-based setup for Postgres and Redis. Cossistant is built for developers who need to embed a customizable chat widget directly into their React applications.
Key Decision Points:
React ecosystem dependency: Cossistant is built exclusively for React and Next.js. Developers using other frameworks like Vue, Svelte, or plain JavaScript will not have a direct integration path.
SDK-first, headless design: The @cossistant/react package exposes headless hooks and primitives rather than a fully styled turnkey widget. This means developers can control the entire UI but must build the presentation layer themselves.
Bundled backend infrastructure: The project ships with a complete backend stack including Hono, tRPC, WebSockets, and Docker containers for Postgres and Redis. Self-hosters will need to run these services to operate the chat system.
Monorepo structure: The codebase is organized as a Turborepo monorepo, making it easier to understand package boundaries but also meaning contributors must be comfortable with monorepo tooling.
Core Features:
Headless React hooks and primitives: The @cossistant/react package provides unstyled building blocks that give developers full control over the widget's appearance and behavior.
Next.js-specific utilities: The @cossistant/next package ships dedicated bindings and helpers for Next.js applications.
Real-time messaging: WebSocket support enables live, bidirectional message delivery without polling.
API-driven architecture: The backend is built on Hono and tRPC, exposing typesafe API endpoints that the frontend SDKs can consume directly.
Built-in authentication: Better Auth handles authentication workflows within the chat infrastructure.
Use Cases:
React or Next.js developers who need to embed a support chat widget into an existing application and want full control over the UI rather than using a hosted, opinionated widget.
Teams that prefer to self-host their chat infrastructure and are comfortable running Docker containers for Postgres and Redis alongside the provided backend services.
Open-Source Alternative Value:
Cossistant provides the full source for both the frontend React SDK and the backend chat infrastructure under an open source model. Developers who adopt it are not dependent on a SaaS chat widget vendor and can run the entire stack on their own infrastructure using the provided Docker setup. The headless component design also means teams can adapt the user interface to match their application without fighting pre-built styling constraints. This is most directly valuable for React developers who have the capability to manage the backend services and want to avoid third-party chat providers.
