> ## Documentation Index
> Fetch the complete documentation index at: https://www.cometchat.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# React UI Kit

> Prebuilt React components for chat, voice, and video calling. Supports React.js, Next.js, React Router, and Astro.

<Accordion title="AI Integration Quick Reference">
  | Field        | Value                                                                                 |
  | ------------ | ------------------------------------------------------------------------------------- |
  | Package      | `@cometchat/chat-uikit-react` v6.3.x                                                  |
  | Peer deps    | `react` >=18, `react-dom` >=18, `rxjs` ^7.8.1                                         |
  | Calling      | Optional — `@cometchat/calls-sdk-javascript`                                          |
  | SSR          | Client-side only. Use `ssr: false` or `client:only="react"`                           |
  | Localization | 19 languages built-in                                                                 |
  | Source       | [GitHub](https://github.com/cometchat/cometchat-uikit-react/tree/v6)                  |
  | AI Skills    | `npx @cometchat/skills add` — [GitHub](https://github.com/cometchat/cometchat-skills) |
</Accordion>

The CometChat React UI Kit provides prebuilt, customizable components for adding chat, voice, and video calling to any React app. Each component handles its own data fetching, real-time listeners, and state — you just drop them into your layout.

<Frame>
  <img src="https://mintcdn.com/cometchat-22654f5b/HFXOvmhiLRb5ClID/images/94312eb7-intro_web_screens-7ee27b256c54ea069273e198ec2aad4e.png?fit=max&auto=format&n=HFXOvmhiLRb5ClID&q=85&s=21d2b906314a417cb1a0d583c64ef822" width="1282" height="802" data-path="images/94312eb7-intro_web_screens-7ee27b256c54ea069273e198ec2aad4e.png" />
</Frame>

***

## Integrate with AI Coding Agents

Use [CometChat Skills](https://github.com/cometchat/cometchat-skills) to add chat to any React project through your AI coding agent. The skill takes an AI-first approach — your agent has a short conversation with you to understand your project and chat requirements, then writes production-grade integration code tailored to the files you already have. One slash — `/cometchat` — works for React, Next.js, React Router, Astro, Expo, bare React Native, Angular, Android, Flutter, and iOS.

Works with Claude Code, Cursor, Codex, VS Code Copilot, Windsurf, Cline, Kiro, and [30+ more agents](https://github.com/cometchat/cometchat-skills).

```bash theme={null}
npx @cometchat/skills add
```

Use `--ide <name>` to target a specific IDE (e.g. `--ide cursor`), or `--ide all` to install for all supported IDEs.

Then in your IDE:

```
/cometchat add chat to my app
```

The skill detects your framework, router, env prefix, and existing auth system. It onboards you to CometChat directly in the terminal — signup, login, and app creation all via the CLI with no browser round-trip. It reads your routes, nav, and components before proposing a placement, shows the plan (which files it will create, modify, and leave untouched), and waits for your approval before writing code.

After the first integration, re-run `/cometchat` anytime to pick from the iteration menu:

* **Customize look & feel** — theme presets (slack / whatsapp / imessage / discord / notion) or your own brand color
* **Add a feature** — 40+ features including calls, reactions, polls, AI smart replies, file sharing, presence
* **Customize a component** — custom message bubbles, headers, composer actions, empty/loading states
* **Add a floating widget** — overlay chat button + drawer on top of your existing app
* **Set up production auth** — replace the dev Auth Key with a server-side token endpoint
* **Set up user management** — server endpoints for creating/updating/deleting CometChat users
* **Run diagnostics** — verify, drift detection, symptom-to-cause lookup

<Accordion title="Recommended: CometChat Docs MCP">
  For deeper component customization (custom views, SDK events, request builders), install the docs MCP:

  **Claude Code:**

  ```bash theme={null}
  claude mcp add --transport http cometchat-docs https://www.cometchat.com/docs/mcp
  ```

  **Cursor** (`.cursor/mcp.json`):

  ```json theme={null}
  { "mcpServers": { "cometchat-docs": { "url": "https://www.cometchat.com/docs/mcp" } } }
  ```

  **Windsurf:**

  ```json theme={null}
  { "mcpServers": { "cometchat-docs": { "type": "sse", "serverUrl": "https://www.cometchat.com/docs/mcp" } } }
  ```

  No authentication required. Not needed for the initial integration — the skill handles it without the MCP.
</Accordion>

<CardGroup cols={2}>
  <Card title="CometChat Skills" icon="wand-magic-sparkles" href="https://github.com/cometchat/cometchat-skills">
    AI-first integration for any React project
  </Card>

  <Card title="Supported IDEs" icon="robot">
    Claude Code · Cursor · Kiro · VS Code Copilot · Windsurf · Cline
  </Card>
</CardGroup>

***

## Try It

<CardGroup>
  <Card title="Live Demo" icon="play" href="https://link.cometchat.com/cometchat-demo">
    Try the full chat experience in your browser
  </Card>

  <Card title="CodeSandbox" icon="code" href="https://link.cometchat.com/react-conversation-list-message">
    Fork, add your credentials, and start building
  </Card>
</CardGroup>

***

## Get Started

<Frame>
  <iframe width="100%" height="400" src="https://www.youtube.com/embed/pz--2nkDVzk" title="YouTube video" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" />
</Frame>

Pick your framework and follow the step-by-step integration guide:

<CardGroup cols={2}>
  <Card title="React.js" icon="react" href="/ui-kit/react/react-js-integration">
    Vite or Create React App
  </Card>

  <Card title="Next.js" icon={<img src="/docs/images/icons/nextjs.svg" alt="Next.js" />} href="/ui-kit/react/next-js-integration">
    App Router with client-side rendering
  </Card>

  <Card title="React Router" icon={<img src="/docs/images/icons/react-router.svg" alt="React Router" />} href="/ui-kit/react/react-router-integration">
    SPA with React Router v6+
  </Card>

  <Card title="Astro" icon={<img src="/docs/images/icons/astro.svg" alt="Astro" />} href="/ui-kit/react/astro-integration">
    React islands with client:only directive
  </Card>
</CardGroup>

***

## Explore

<CardGroup cols={2}>
  <Card title="Components" icon="grid-2" href="/ui-kit/react/components-overview">
    Browse all prebuilt UI components
  </Card>

  <Card title="Features" icon="comments" href="/ui-kit/react/core-features">
    Chat, calling, AI, and extensions
  </Card>

  <Card title="Theming" icon="paintbrush" href="/ui-kit/react/theme">
    Colors, fonts, dark mode, and custom styling
  </Card>

  <Card title="Guides" icon="book" href="/ui-kit/react/guide-overview">
    Threaded messages, new chat, search, and more
  </Card>
</CardGroup>

***

## Resources

<CardGroup cols={3}>
  <Card title="Sample App" icon="github" href="https://github.com/cometchat/cometchat-uikit-react/tree/v6/sample-app">
    Working reference app
  </Card>

  <Card title="Source Code" icon="code" href="https://github.com/cometchat/cometchat-uikit-react/tree/v6">
    Full UI Kit source on GitHub
  </Card>

  <Card title="Figma" icon="figma" href="https://www.figma.com/community/file/1442863561340379957/cometchat-ui-kit-for-web">
    Design resources and prototyping
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/ui-kit/react/troubleshooting">
    Common issues and fixes
  </Card>

  <Card title="Support" icon="headset" href="https://help.cometchat.com/hc/en-us/requests/new">
    Open a support ticket
  </Card>

  <Card title="Migration Guide" icon="arrow-up" href="/ui-kit/react/upgrading-from-v5">
    Upgrading from v5
  </Card>
</CardGroup>
