# Docs

## root

- [Cossistant documentation](/docs): Install Cossistant's open-source AI and human support widget for Next.js, React, or a browser script embed.

## advanced

- [Advanced](/docs/advanced): Build your own support UI from the same logic and primitives behind the shipped widget.
- [Primitives](/docs/advanced/primitives): Headless building blocks for teams that want to build their own support UI.

## concepts

- [Visitors](/docs/concepts): Anonymous, browser-scoped visitors created by the Cossistant SDK.
- [Contacts](/docs/concepts/contacts): Identified visitors with metadata and cross-device conversation history.
- [Conversations](/docs/concepts/conversations): Real-time chat threads between visitors and your support team.
- [Timeline Items](/docs/concepts/timeline-items): Flexible building blocks that make up conversation timelines.

## others

- [Contribute to Cossistant](/docs/others/contributors): Set up the Cossistant monorepo locally, understand the repo layout, and ship contribution-ready pull requests.
- [MCP](/docs/others/mcp): Connect AI agents to your Cossistant support context with the hosted MCP server.
- [Mentions](/docs/others/mentions): Powered by amazing people and open source projects.
- [Third-party services](/docs/others/third-party-services): Managed-cloud service roles, data categories, and customer controls for Cossistant.

## quickstart

- [Next.js](/docs/quickstart): Install and launch the Cossistant support widget in Next.js.
- [API Keys](/docs/quickstart/api-keys): Configure public API keys for Next.js and React support widgets.
- [React](/docs/quickstart/react): Install and launch the Cossistant support widget in React.

## self-host

- [Overview](/docs/self-host): Understand the billing, storage, email, and analytics responsibilities a self-hosted Cossistant deployment needs, and choose the setup path that fits your stack.
- [Analytics](/docs/self-host/analytics): Decide how self-hosted Cossistant should handle Tinybird-backed analytics and the optional DataFast script.
- [Billing](/docs/self-host/billing): Control whether self-hosted Cossistant uses Polar for billing and metering, and understand what changes when billing is disabled.
- [Email Setup](/docs/self-host/email-setup): Choose and configure the transactional email provider Cossistant uses for outbound mail, replies, and lifecycle events.
- [Storage](/docs/self-host/storage): Configure the object storage Cossistant needs for uploads, public asset reads, and optional CDN-backed delivery.

## support-component

- [Overview](/docs/support-component): Ship the default Support widget first. Then brand it in small steps.
- [Change One Thing](/docs/support-component/customization): Keep the default widget and swap one small piece at a time.
- [Manual events reference](/docs/support-component/events): Emit and subscribe to Support events from custom widget code.
- [Hooks Reference](/docs/support-component/hooks): Curated hooks for Support state, navigation, identity, conversations, and custom pages.
- [Pages & Layouts](/docs/support-component/routing): Keep the default widget until you need custom pages, inline embeds, or your own shell.
- [Support State](/docs/support-component/support-state): Configure typed feature flags and onboarding state with support.ts.
- [Copy & Locale](/docs/support-component/text): Change widget copy and language without rewriting the UI.
- [Match Your Brand](/docs/support-component/theme): Brand the Support widget with CSS variables, the theme prop, and your app tokens.
- [Types Reference](/docs/support-component/types): Curated type reference for common Support props, hooks, events, and shared widget data.

## user-feedback

- [User feedback](/docs/user-feedback): Collect topic, rating, and comment feedback with the drop-in widget or provider-optional hooks.

## what

- [What is Cossistant?](/docs/what): Understand Cossistant's default widget, reusable SDK, and deployment choices.