![hero](github.png)

<p align="center">
    Open source chat &lt;Support /&gt; widget for React
    <br />
    <br />
    <a href="https://github.com/cossistant/cossistant/issues">Issues</a>
    ·
    <a href="https://cossistant.com/docs">Docs</a>
    ·
    <a href="https://discord.gg/vQkPjgvzcc">Discord</a>
</p>

## About Cossistant

Cossistant is an open source chat support widget for the React ecosystem. Built by developers, for developers who need a flexible, customizable chat solution that seamlessly integrates into their applications. We provide headless components, real-time messaging, and complete backend infrastructure—all with a code-first, API-driven philosophy that prioritizes developer experience and AI-friendly documentation.

## Get Started

**Using Cossistant in your app?**
→ Check out our [Quickstart Guide](https://cossistant.com/docs/quickstart)

**Contributing to Cossistant?**
→ Read the [Contributors Guide](https://cossistant.com/docs/others/contributors)

## Packages

- **[@cossistant/react](https://www.npmjs.com/package/@cossistant/react)** - React SDK with headless hooks and primitives
- **[@cossistant/next](https://www.npmjs.com/package/@cossistant/next)** - Next.js-specific bindings and utilities

For full documentation, visit [cossistant.com/docs](https://cossistant.com/docs)

## Tech Stack

- Monorepo (Turborepo)
- Bun
- React & Next.js
- TypeScript
- Hono (API)
- tRPC
- Drizzle ORM
- Better Auth
- TailwindCSS
- WebSockets
- Docker (Postgres + Redis)

## License

This project is licensed under the **[AGPL-3.0](https://opensource.org/licenses/AGPL-3.0)** for non-commercial use.

### Commercial Use

For commercial use or deployments requiring a setup fee, please contact us
for a commercial license at [anthony@cossistant.com](mailto:anthony@cossistant.com).

By using this software, you agree to the terms of the license.
<br />
<br />

### Open source friends

Proudly part of Vercel open source program:
<br />
<br />
<a href="https://vercel.com/oss">
<img alt="Vercel OSS Program" src="https://vercel.com/oss/program-badge-2026.svg" />
</a>
<br />
<br />
You can also join our open source program:
<br />
<br />
<a href="https://cossistant.com/open-source-program">
<img alt="Cossistant OSS Program" src="https://cdn.cossistant.com/oss/oss-friends.svg" />
</a>