From 04aa7cff96e3b77726c603865fce3aaade64879a Mon Sep 17 00:00:00 2001 From: "Ketan (CometChat)" Date: Tue, 22 Sep 2026 21:29:56 +0530 Subject: [PATCH 1/4] docs(mcp-server): update MCP page for docs-mcp v0.1.6 - Transport is Streamable HTTP, not SSE. Drop "type": "sse" from the Windsurf snippet and the SSE choice from the VS Code steps. - List all four tools, including list_cometchat_bundles, as the server describes them in v0.1.6. - Claude: lead with the connector directory listing (claude.com/connectors/cometchat) and keep the custom connector as the fallback, using the current Customize > Connectors menus. - Add Claude Code and Codex steps, and one-click install links for Cursor and VS Code. - Windsurf is now Devin Desktop: point to its current config file and use "url", which both of its agents accept. - Fix the Source link text (github.com/cometchat/docs-mcp) and replace the "always in sync" claim with how the search index refreshes. - React UI Kit v6 overview: point the Docs MCP accordion at https://mcp.cometchat.com/mcp instead of Mintlify's auto-generated /docs/mcp server, and drop "type": "sse". Co-Authored-By: Claude Opus 5 --- mcp-server.mdx | 186 +++++++++++++++++++++++++++-------- ui-kit/react/v6/overview.mdx | 10 +- 2 files changed, 151 insertions(+), 45 deletions(-) diff --git a/mcp-server.mdx b/mcp-server.mdx index 901293132..b1669bf88 100644 --- a/mcp-server.mdx +++ b/mcp-server.mdx @@ -5,11 +5,12 @@ description: "Connect CometChat to Claude, Cursor, Windsurf, VS Code, and any ot canonical: "https://www.cometchat.com/docs/mcp-server" --- -The **CometChat MCP server** lets Claude, Cursor, Windsurf, VS Code, and any -other Model Context Protocol–compatible agent integrate CometChat into your -app from natural-language prompts. Ask the agent to *"add a chat tab where -users can DM each other"* and it uses the MCP to read CometChat's docs, -pick the right components for your stack, and write the integration code. +The **CometChat MCP server** lets Claude, Claude Code, Cursor, VS Code, Codex, +Windsurf, and any other Model Context Protocol–compatible agent integrate +CometChat into your app from natural-language prompts. Ask the agent to +*"add a chat tab where users can DM each other"* and it uses the MCP to read +CometChat's docs, pick the right components for your stack, and write the +integration code. The server is **read-only** and **needs no account or API key** — it surfaces CometChat's public documentation and curated implementation recipes. @@ -20,21 +21,69 @@ CometChat's public documentation and curated implementation recipes. https://mcp.cometchat.com/mcp ``` -Transport: HTTP with Server-Sent Events. No authentication required. +Transport: Streamable HTTP. No authentication required. The server does not +offer the older SSE-only transport, so if your client asks for a transport +type, choose **HTTP** (Streamable HTTP). + +## One-click install + + + + Open CometChat in Claude's connector directory and click **Add to Claude**. + + + Opens Cursor and asks you to confirm the install. + + + Opens VS Code and asks you to confirm the install. + + ## Connect from your agent -### Claude (Desktop or claude.ai) + +If you installed [CometChat Agent Skills](/agent-skills), the installer already +connected this server to your agent as `cometchat-docs`. You don't need to add +it again. + + +### Claude (claude.ai and Claude Desktop) + +CometChat is listed in Claude's connector directory. + +1. Open [CometChat in the connector directory](https://claude.com/connectors/cometchat) + and click **Add to Claude**. Or, in Claude, go to **Customize → Connectors**, + click **+**, choose **Browse connectors**, find **CometChat**, and click + **Connect**. +2. In a conversation, click **+** in the lower left, hover over **Connectors**, + and turn on **CometChat**. + +On Team and Enterprise plans, an Owner first adds the connector from +**Organization settings → Connectors → Browse connectors**. + +**Fallback: add it as a custom connector.** If the directory isn't available +to you, go to **Customize → Connectors**, click **+**, choose +**Add custom connector**, paste `https://mcp.cometchat.com/mcp` as the remote +MCP server URL, and click **Add**. Free plans allow one custom connector. See +Anthropic's [custom connector guide](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp). -1. Open **Settings → Connectors**. -2. Click **Add custom connector**. -3. Name it `CometChat`, paste the URL `https://mcp.cometchat.com/mcp`, and click **Add**. -4. In a new conversation, attach **CometChat** from the connectors picker and prompt away. +### Claude Code + +Run: + +```bash +claude mcp add --transport http cometchat https://mcp.cometchat.com/mcp +``` + +The server is added for the current project. Add `--scope user` to make it +available in every project. Check the connection with `claude mcp list`, or +run `/mcp` inside Claude Code. ### Cursor -1. `Cmd+Shift+P` (macOS) / `Ctrl+Shift+P` (Windows) → **Open MCP settings**. -2. Click **Add custom MCP** and paste: +1. Use the [one-click install link](https://cursor.com/en/install-mcp?name=cometchat&config=eyJ1cmwiOiJodHRwczovL21jcC5jb21ldGNoYXQuY29tL21jcCJ9), + or add this to `~/.cursor/mcp.json` (every project) or `.cursor/mcp.json` + (one project): ```json { @@ -46,32 +95,70 @@ Transport: HTTP with Server-Sent Events. No authentication required. } ``` -### Windsurf +2. Turn the server on or off from **Customize** in the sidebar. + +### Visual Studio Code (Copilot Agent) -1. Click the **Plugins** (hammer) icon → **Manage plugins** → **View raw config**. -2. Paste: +1. Use the [one-click install link](https://insiders.vscode.dev/redirect/mcp/install?name=cometchat&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.cometchat.com%2Fmcp%22%7D) + ([VS Code Insiders](https://insiders.vscode.dev/redirect/mcp/install?name=cometchat&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.cometchat.com%2Fmcp%22%7D&quality=insiders)), + or search for `@mcp cometchat` in the Extensions view and click **Install**. +2. To add it by hand instead, run **MCP: Add Server** from the Command Palette + (`Cmd+Shift+P` / `Ctrl+Shift+P`), choose **HTTP**, and enter + `https://mcp.cometchat.com/mcp`. Or add this to `.vscode/mcp.json`: ```json { - "mcpServers": { + "servers": { "cometchat": { - "type": "sse", - "serverUrl": "https://mcp.cometchat.com/mcp" + "type": "http", + "url": "https://mcp.cometchat.com/mcp" } } } ``` -3. Save and click **Refresh**. +3. When VS Code asks, confirm that you trust the server. -### Visual Studio Code (Copilot Agent) +### Codex + +Run: + +```bash +codex mcp add cometchat --url https://mcp.cometchat.com/mcp +``` + +Or add this to `~/.codex/config.toml`: + +```toml +[mcp_servers.cometchat] +url = "https://mcp.cometchat.com/mcp" +``` + +The Codex CLI, the IDE extension, and the ChatGPT desktop app share this +configuration. Check the connection with `codex mcp list`, or run `/mcp` in +the Codex TUI. + +### Windsurf (Devin Desktop) -1. `Cmd+Shift+P` / `Ctrl+Shift+P` → **MCP: Add MCP Server**. -2. Enter: - - **Server Name:** `CometChat` - - **Server URL:** `https://mcp.cometchat.com/mcp` - - **Transport:** SSE -3. Confirm. +Windsurf is now Devin Desktop. + +1. Open your MCP config file. With the Cascade agent, click the `...` (Actions) + menu at the top right of the Cascade panel, then **Open MCP config file**. + With the Devin Local agent, edit the config file described in + [Devin's MCP configuration docs](https://docs.devin.ai/cli/extensibility/mcp/configuration). +2. Add CometChat under `mcpServers`: + +```json +{ + "mcpServers": { + "cometchat": { + "url": "https://mcp.cometchat.com/mcp" + } + } +} +``` + +3. Save the file. ## Example prompts @@ -89,23 +176,34 @@ and write the code into your project. ## What the connector exposes -### Three tools (all read-only) +### Four tools (all read-only) - + - Search SDK guides, UI Kit references, REST API docs, and OpenAPI - specs. Returns ranked snippets with direct links. + Search SDK guides, UI Kit references, REST API docs, integration + tutorials, and OpenAPI specs. Returns ranked snippets with titles and + direct links. Pages for the current version of each SDK and UI Kit are + preferred, and each result says whether it is current. Pass `version` + (for example `v5`) to search older docs. - Fetch the full content of any documentation page as markdown by URL - or relative path. + Fetch one documentation page as markdown, with its title and section, + by full URL or relative path such as `/sdk/javascript/overview`. Moved + pages are followed to their new location. - Return a curated implementation recipe — prerequisites, install, - configuration, working code — for a named scenario. + Return a curated implementation recipe by name — prerequisites, install + commands, configuration, working code, and common pitfalls — with the + date it was last verified. + + + List every available implementation bundle with its identifier, title, + target framework, and last-verified date. +Every tool returns structured results that match a declared output schema. + ### Ten curated implementation bundles | Bundle | What it covers | @@ -121,6 +219,9 @@ and write the code into your project. | `multi-tenant-chat` | Multi-tenant SaaS chat — auth, isolation, tenant-scoped users | | `presence-and-typing` | Online presence, typing indicators, read receipts | +Each bundle is also available as an MCP resource at +`cometchat://bundles/`. + ### Orientation skill resource The MCP also exposes a `cometchat://skills/overview` resource — a structured @@ -129,12 +230,17 @@ products, decision tree, and common pitfalls. ## Source -The MCP server is open-source at -[`github.com/cometchat/cometchat-mcp`](https://github.com/cometchat/docs-mcp). -Built from this very documentation repository, so the content it surfaces -is always in sync with what you see on the docs site. +The MCP server is open source (Apache-2.0) at +[`github.com/cometchat/docs-mcp`](https://github.com/cometchat/docs-mcp). + +Search runs on an index built from the +[CometChat docs repository](https://github.com/cometchat/docs). The server +rebuilds the index when the docs change, so a new or edited page can take a +few minutes to show up in search results. `fetch_cometchat_doc_page` reads +pages directly from this site. The implementation bundles are curated +separately, and each one records the date it was last verified. ## Support Questions, feedback, or feature requests: open an issue on the -[GitHub repository](https://github.com/cometchat/docs-mcp/issues) \ No newline at end of file +[GitHub repository](https://github.com/cometchat/docs-mcp/issues) diff --git a/ui-kit/react/v6/overview.mdx b/ui-kit/react/v6/overview.mdx index 56c133bdb..06d418145 100644 --- a/ui-kit/react/v6/overview.mdx +++ b/ui-kit/react/v6/overview.mdx @@ -66,20 +66,20 @@ For deeper component customization (custom views, SDK events, request builders), **Claude Code:** ```bash -claude mcp add --transport http cometchat-docs https://www.cometchat.com/docs/mcp +claude mcp add --transport http cometchat-docs https://mcp.cometchat.com/mcp ``` **Cursor** (`.cursor/mcp.json`): ```json -{ "mcpServers": { "cometchat-docs": { "url": "https://www.cometchat.com/docs/mcp" } } } +{ "mcpServers": { "cometchat-docs": { "url": "https://mcp.cometchat.com/mcp" } } } ``` -**Windsurf:** +**Windsurf (Devin Desktop):** ```json -{ "mcpServers": { "cometchat-docs": { "type": "sse", "serverUrl": "https://www.cometchat.com/docs/mcp" } } } +{ "mcpServers": { "cometchat-docs": { "url": "https://mcp.cometchat.com/mcp" } } } ``` -No authentication required. Not needed for the initial integration — the skill handles it without the MCP. +No authentication required. Not needed for the initial integration — the skill handles it without the MCP. For VS Code, Codex, and Claude, see [MCP Integration](/mcp-server). From c6d3a00f81c25fb36c0bfc6ae964445464f0a69a Mon Sep 17 00:00:00 2001 From: "Ketan (CometChat)" Date: Wed, 23 Sep 2026 14:55:19 +0530 Subject: [PATCH 2/4] docs(ui-kit): add AI agent + Docs MCP sections to all platform overviews MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit React v7, Angular v5, Android v6 and Flutter V6 had no AI-agent section at all — the pattern only ever landed on the superseded v6/v5/v4 pages, so the deprecated docs had better AI onboarding than the current ones. Adds the full "Integrate with AI Coding Agents" section plus the Docs MCP accordion to those four, with the correct target version, detection story and credentials file per platform. - React Native v5 and iOS v5 already had the section; they get the MCP accordion and the AI Skills quick-reference row. - Vue and Kotlin get the standalone MCP accordion only. agent-skills.mdx lists six supported platforms and neither is one, so a Skills section there would be a false promise; the Docs MCP does index their pages. - Standardises the MCP server name on `cometchat-docs` across mcp-server.mdx (CLI commands, all four JSON/TOML blocks, and name= in all five one-click install URLs) so following the page no longer mounts a second copy of the server the Skills installer already registered. - Corrects "the skill handles it without the MCP": per agent-skills.mdx the installer wires the MCP up by default for Claude Code, Cursor, Gemini and Codex, with --no-mcp to opt out. - Replaces the unsupported "30+ more agents" claim on the current overviews with the 11 agents that agent-skills.mdx and the cometchat-skills README actually list. 14 legacy/integration pages still carry the old claim and are left for a separate pass. - Fixes the "Claude" -> "Claude Desktop" pointer wording. Verified: all ten files compile under @mdx-js/mdx, and every internal link and heading anchor in them resolves. `mint broken-links` is still blocked by the pre-existing parse error at sdk/react-native/authentication-overview.mdx:16, which #527 fixes. --- mcp-server.mdx | 24 ++++++------ ui-kit/android/overview.mdx | 65 ++++++++++++++++++++++++++++++++ ui-kit/angular/overview.mdx | 65 +++++++++++++++++++++++++++++++- ui-kit/flutter/overview.mdx | 65 ++++++++++++++++++++++++++++++++ ui-kit/ios/overview.mdx | 36 +++++++++++++++++- ui-kit/kotlin/overview.mdx | 23 +++++++++++ ui-kit/react-native/overview.mdx | 36 +++++++++++++++++- ui-kit/react/overview.mdx | 65 ++++++++++++++++++++++++++++++++ ui-kit/react/v6/overview.mdx | 2 +- ui-kit/vue/overview.mdx | 23 +++++++++++ 10 files changed, 386 insertions(+), 18 deletions(-) diff --git a/mcp-server.mdx b/mcp-server.mdx index b1669bf88..bdf47c50e 100644 --- a/mcp-server.mdx +++ b/mcp-server.mdx @@ -31,10 +31,10 @@ type, choose **HTTP** (Streamable HTTP). Open CometChat in Claude's connector directory and click **Add to Claude**. - + Opens Cursor and asks you to confirm the install. - + Opens VS Code and asks you to confirm the install. @@ -44,7 +44,7 @@ type, choose **HTTP** (Streamable HTTP). If you installed [CometChat Agent Skills](/agent-skills), the installer already connected this server to your agent as `cometchat-docs`. You don't need to add -it again. +it again — skip to [Example prompts](#example-prompts). ### Claude (claude.ai and Claude Desktop) @@ -72,7 +72,7 @@ Anthropic's [custom connector guide](https://support.claude.com/en/articles/1117 Run: ```bash -claude mcp add --transport http cometchat https://mcp.cometchat.com/mcp +claude mcp add --transport http cometchat-docs https://mcp.cometchat.com/mcp ``` The server is added for the current project. Add `--scope user` to make it @@ -81,14 +81,14 @@ run `/mcp` inside Claude Code. ### Cursor -1. Use the [one-click install link](https://cursor.com/en/install-mcp?name=cometchat&config=eyJ1cmwiOiJodHRwczovL21jcC5jb21ldGNoYXQuY29tL21jcCJ9), +1. Use the [one-click install link](https://cursor.com/en/install-mcp?name=cometchat-docs&config=eyJ1cmwiOiJodHRwczovL21jcC5jb21ldGNoYXQuY29tL21jcCJ9), or add this to `~/.cursor/mcp.json` (every project) or `.cursor/mcp.json` (one project): ```json { "mcpServers": { - "cometchat": { + "cometchat-docs": { "url": "https://mcp.cometchat.com/mcp" } } @@ -99,8 +99,8 @@ run `/mcp` inside Claude Code. ### Visual Studio Code (Copilot Agent) -1. Use the [one-click install link](https://insiders.vscode.dev/redirect/mcp/install?name=cometchat&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.cometchat.com%2Fmcp%22%7D) - ([VS Code Insiders](https://insiders.vscode.dev/redirect/mcp/install?name=cometchat&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.cometchat.com%2Fmcp%22%7D&quality=insiders)), +1. Use the [one-click install link](https://insiders.vscode.dev/redirect/mcp/install?name=cometchat-docs&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.cometchat.com%2Fmcp%22%7D) + ([VS Code Insiders](https://insiders.vscode.dev/redirect/mcp/install?name=cometchat-docs&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.cometchat.com%2Fmcp%22%7D&quality=insiders)), or search for `@mcp cometchat` in the Extensions view and click **Install**. 2. To add it by hand instead, run **MCP: Add Server** from the Command Palette (`Cmd+Shift+P` / `Ctrl+Shift+P`), choose **HTTP**, and enter @@ -109,7 +109,7 @@ run `/mcp` inside Claude Code. ```json { "servers": { - "cometchat": { + "cometchat-docs": { "type": "http", "url": "https://mcp.cometchat.com/mcp" } @@ -124,13 +124,13 @@ run `/mcp` inside Claude Code. Run: ```bash -codex mcp add cometchat --url https://mcp.cometchat.com/mcp +codex mcp add cometchat-docs --url https://mcp.cometchat.com/mcp ``` Or add this to `~/.codex/config.toml`: ```toml -[mcp_servers.cometchat] +[mcp_servers.cometchat-docs] url = "https://mcp.cometchat.com/mcp" ``` @@ -151,7 +151,7 @@ Windsurf is now Devin Desktop. ```json { "mcpServers": { - "cometchat": { + "cometchat-docs": { "url": "https://mcp.cometchat.com/mcp" } } diff --git a/ui-kit/android/overview.mdx b/ui-kit/android/overview.mdx index bea078429..829e0056f 100644 --- a/ui-kit/android/overview.mdx +++ b/ui-kit/android/overview.mdx @@ -14,6 +14,7 @@ description: "Prebuilt, customizable UI components for chat & messaging, voice & | Peer deps | `com.cometchat:chat-sdk-android` >=4.x, `minSdk` 28 | | Calling | Optional — `com.cometchat:calls-sdk-android` | | Source | [GitHub](https://github.com/cometchat/cometchat-uikit-android) | +| AI Skills | `npx @cometchat/skills add` — [Agent Skills](/agent-skills) | @@ -30,6 +31,70 @@ It ships in two flavors that share the same core (ViewModels, repositories, even --- +## Integrate with AI Coding Agents + +Use [CometChat Agent Skills](/agent-skills) to add chat to any Android project through your AI coding agent. The skills take 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. The Android skills target **Android UI Kit v6** and cover both Jetpack Compose and Kotlin (XML Views). + +Works with Claude Code, Cursor, Codex, GitHub Copilot, Kiro, Replit Agent, Gemini, Windsurf, Cline, Continue, and Aider — see the [full list](/agent-skills#supported-agents). + +```bash +npx @cometchat/skills add +``` + +Use `--ide ` to target a specific agent (e.g. `--ide cursor`), or `--ide all` to install for every supported agent. + +Then in your agent: + +``` +/cometchat add chat to my app +``` + +The skills detect your toolkit (Compose or XML Views), Gradle setup, navigation pattern, and existing auth system. They onboard you to CometChat directly in the terminal — signup, login, and app creation all via the CLI. They read your activities, navigation graph, and layouts before proposing a placement, show the plan (which files they will create, modify, and leave untouched), and wait for your approval before writing code. Credentials land in `app/src/main/assets/cometchat-settings.json`. + +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 +- **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 +- **Set up push notifications** — FCM end-to-end +- **Run diagnostics** — verify, drift detection, symptom-to-cause lookup + + + +For deeper component customization (custom views, SDK events, request builders), connect the **CometChat Docs MCP** so your agent reads the current docs instead of guessing at APIs: + +**Claude Code:** +```bash +claude mcp add --transport http cometchat-docs https://mcp.cometchat.com/mcp +``` + +**Cursor** (`.cursor/mcp.json`): +```json +{ "mcpServers": { "cometchat-docs": { "url": "https://mcp.cometchat.com/mcp" } } } +``` + +**Windsurf (Devin Desktop):** +```json +{ "mcpServers": { "cometchat-docs": { "url": "https://mcp.cometchat.com/mcp" } } } +``` + +No authentication required. `npx @cometchat/skills add` wires this up automatically for Claude Code, Cursor, Gemini, and Codex (pass `--no-mcp` to skip it) — add it by hand only for the other agents. For Claude Desktop, VS Code, and Codex, see [MCP Integration](/mcp-server). + + + + + + Install, supported platforms, credentials, and the full skill list + + + Connect the Docs MCP to Claude, Cursor, VS Code, Codex, and Windsurf + + + +--- + ## Get Started Every integration starts the same way — install the SDK, initialize, and log in — then you build the UI with your chosen toolkit. Start with the prerequisites, then pick a path: diff --git a/ui-kit/angular/overview.mdx b/ui-kit/angular/overview.mdx index ee0f4ebb8..72c0ca02f 100644 --- a/ui-kit/angular/overview.mdx +++ b/ui-kit/angular/overview.mdx @@ -14,7 +14,7 @@ description: "Use CometChat Angular UI Kit to add standalone chat components, vo | Angular | v18, v19, v20, v21, v22 (v22 requires Node.js 24+) | | Localization | 19 languages built-in | | Source | [GitHub](https://github.com/cometchat/cometchat-uikit-angular/tree/v5) | -| AI Skills | `npx @cometchat/skills add` — [GitHub](https://github.com/cometchat/cometchat-skills) | +| AI Skills | `npx @cometchat/skills add` — [Agent Skills](/agent-skills) | @@ -26,6 +26,69 @@ The CometChat Angular UI Kit provides prebuilt, customizable standalone componen --- +## Integrate with AI Coding Agents + +Use [CometChat Agent Skills](/agent-skills) to add chat to any Angular project through your AI coding agent. The skills take 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. The Angular skills target **Angular UI Kit v5** and cover both Angular CLI and Nx workspaces. + +Works with Claude Code, Cursor, Codex, GitHub Copilot, Kiro, Replit Agent, Gemini, Windsurf, Cline, Continue, and Aider — see the [full list](/agent-skills#supported-agents). + +```bash +npx @cometchat/skills add +``` + +Use `--ide ` to target a specific agent (e.g. `--ide cursor`), or `--ide all` to install for every supported agent. + +Then in your agent: + +``` +/cometchat add chat to my app +``` + +The skills detect your workspace layout, routing, and existing auth system. They onboard you to CometChat directly in the terminal — signup, login, and app creation all via the CLI. They read your routes, nav, and standalone components before proposing a placement, show the plan (which files they will create, modify, and leave untouched), and wait for your approval before writing code. Credentials land in `src/environments/environment.ts`. + +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 +- **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 + + + +For deeper component customization (custom views, SDK events, request builders), connect the **CometChat Docs MCP** so your agent reads the current docs instead of guessing at APIs: + +**Claude Code:** +```bash +claude mcp add --transport http cometchat-docs https://mcp.cometchat.com/mcp +``` + +**Cursor** (`.cursor/mcp.json`): +```json +{ "mcpServers": { "cometchat-docs": { "url": "https://mcp.cometchat.com/mcp" } } } +``` + +**Windsurf (Devin Desktop):** +```json +{ "mcpServers": { "cometchat-docs": { "url": "https://mcp.cometchat.com/mcp" } } } +``` + +No authentication required. `npx @cometchat/skills add` wires this up automatically for Claude Code, Cursor, Gemini, and Codex (pass `--no-mcp` to skip it) — add it by hand only for the other agents. For Claude Desktop, VS Code, and Codex, see [MCP Integration](/mcp-server). + + + + + + Install, supported platforms, credentials, and the full skill list + + + Connect the Docs MCP to Claude, Cursor, VS Code, Codex, and Windsurf + + + +--- + ## Try It diff --git a/ui-kit/flutter/overview.mdx b/ui-kit/flutter/overview.mdx index ff1544346..501915f0d 100644 --- a/ui-kit/flutter/overview.mdx +++ b/ui-kit/flutter/overview.mdx @@ -12,6 +12,7 @@ description: "Use CometChat Flutter UI Kit V6 to add prebuilt chat widgets, call | Import | `import 'package:cometchat_chat_uikit/cometchat_chat_uikit.dart';` | | Purpose | Use CometChat Flutter UI Kit V6 to add prebuilt chat widgets, calls, theming, localization, and customizable messaging experiences. | | Related | [Getting Started With CometChat Flutter UI Kit V6](/ui-kit/flutter/getting-started) · [Overview](/ui-kit/flutter/components-overview) | +| AI Skills | `npx @cometchat/skills add` — [Agent Skills](/agent-skills) | @@ -40,6 +41,70 @@ The **CometChat UI Kit V6** for Flutter is a major architectural evolution of th *** +## **Integrate with AI Coding Agents** + +Use [CometChat Agent Skills](/agent-skills) to add chat to any Flutter project through your AI coding agent. The skills take 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. The Flutter skills target **Flutter UI Kit V6**, including its BLoC architecture. + +Works with Claude Code, Cursor, Codex, GitHub Copilot, Kiro, Replit Agent, Gemini, Windsurf, Cline, Continue, and Aider — see the [full list](/agent-skills#supported-agents). + +```bash +npx @cometchat/skills add +``` + +Use `--ide ` to target a specific agent (e.g. `--ide cursor`), or `--ide all` to install for every supported agent. + +Then in your agent: + +``` +/cometchat add chat to my app +``` + +The skills detect your project structure, routing, state management, and existing auth system. They onboard you to CometChat directly in the terminal — signup, login, and app creation all via the CLI. They read your routes, navigation, and widgets before proposing a placement, show the plan (which files they will create, modify, and leave untouched), and wait for your approval before writing code. Credentials land in `cometchat-settings.json`, which the skills register as an asset in `pubspec.yaml`. + +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 +* **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 +* **Set up push notifications** — APNs + FCM end-to-end +* **Run diagnostics** — verify, drift detection, symptom-to-cause lookup + + + +For deeper component customization (custom views, SDK events, request builders), connect the **CometChat Docs MCP** so your agent reads the current docs instead of guessing at APIs: + +**Claude Code:** +```bash +claude mcp add --transport http cometchat-docs https://mcp.cometchat.com/mcp +``` + +**Cursor** (`.cursor/mcp.json`): +```json +{ "mcpServers": { "cometchat-docs": { "url": "https://mcp.cometchat.com/mcp" } } } +``` + +**Windsurf (Devin Desktop):** +```json +{ "mcpServers": { "cometchat-docs": { "url": "https://mcp.cometchat.com/mcp" } } } +``` + +No authentication required. `npx @cometchat/skills add` wires this up automatically for Claude Code, Cursor, Gemini, and Codex (pass `--no-mcp` to skip it) — add it by hand only for the other agents. For Claude Desktop, VS Code, and Codex, see [MCP Integration](/mcp-server). + + + + + + Install, supported platforms, credentials, and the full skill list + + + Connect the Docs MCP to Claude, Cursor, VS Code, Codex, and Windsurf + + + +*** + ## **Integration** ### **UI Components (Assemble It Yourself)** diff --git a/ui-kit/ios/overview.mdx b/ui-kit/ios/overview.mdx index b12e44b7d..c9991e653 100644 --- a/ui-kit/ios/overview.mdx +++ b/ui-kit/ios/overview.mdx @@ -35,7 +35,7 @@ description: "Integrate chat functionality into iOS applications with prebuilt, | Peer Dependencies | CometChatSDK >= 4.0.0 | | Platforms | iOS 13.0+, iPadOS 13.0+, Mac Catalyst 13.0+ | | Language | Swift 5.0+ | -| AI Skills | `npx @cometchat/skills add` — [GitHub](https://github.com/cometchat/cometchat-skills) | +| AI Skills | `npx @cometchat/skills add` — [Agent Skills](/agent-skills) | | License | MIT | --- @@ -57,7 +57,7 @@ The CometChat UI Kit for iOS provides a seamless solution to integrate chat func Use [CometChat Skills](https://github.com/cometchat/cometchat-skills) to add chat to any iOS 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. -Works with Claude Code, Cursor, Codex, VS Code Copilot, Windsurf, Cline, Kiro, and [30+ more agents](https://github.com/cometchat/cometchat-skills). +Works with Claude Code, Cursor, Codex, GitHub Copilot, Kiro, Replit Agent, Gemini, Windsurf, Cline, Continue, and Aider — see the [full list](/agent-skills#supported-agents). ```bash npx @cometchat/skills add @@ -82,6 +82,38 @@ After the first integration, re-run `/cometchat` anytime to pick from the iterat - **Set up user management** — server endpoints for creating/updating/deleting CometChat users - **Run diagnostics** — verify, drift detection, symptom-to-cause lookup + + +For deeper component customization (custom views, SDK events, request builders), connect the **CometChat Docs MCP** so your agent reads the current docs instead of guessing at APIs: + +**Claude Code:** +```bash +claude mcp add --transport http cometchat-docs https://mcp.cometchat.com/mcp +``` + +**Cursor** (`.cursor/mcp.json`): +```json +{ "mcpServers": { "cometchat-docs": { "url": "https://mcp.cometchat.com/mcp" } } } +``` + +**Windsurf (Devin Desktop):** +```json +{ "mcpServers": { "cometchat-docs": { "url": "https://mcp.cometchat.com/mcp" } } } +``` + +No authentication required. `npx @cometchat/skills add` wires this up automatically for Claude Code, Cursor, Gemini, and Codex (pass `--no-mcp` to skip it) — add it by hand only for the other agents. For Claude Desktop, VS Code, and Codex, see [MCP Integration](/mcp-server). + + + + + + Install, supported platforms, credentials, and the full skill list + + + Connect the Docs MCP to Claude, Cursor, VS Code, Codex, and Windsurf + + + --- ## Try It diff --git a/ui-kit/kotlin/overview.mdx b/ui-kit/kotlin/overview.mdx index 5091da019..1f41956b4 100644 --- a/ui-kit/kotlin/overview.mdx +++ b/ui-kit/kotlin/overview.mdx @@ -47,6 +47,29 @@ Kindly, click on below button to download our Java Sample App. + + +Connect the **CometChat Docs MCP** so your AI coding agent reads CometChat's current documentation instead of guessing at APIs: + +**Claude Code:** +```bash +claude mcp add --transport http cometchat-docs https://mcp.cometchat.com/mcp +``` + +**Cursor** (`.cursor/mcp.json`): +```json +{ "mcpServers": { "cometchat-docs": { "url": "https://mcp.cometchat.com/mcp" } } } +``` + +**Windsurf (Devin Desktop):** +```json +{ "mcpServers": { "cometchat-docs": { "url": "https://mcp.cometchat.com/mcp" } } } +``` + +No authentication required. The server is read-only. For Claude Desktop, VS Code, and Codex, see [MCP Integration](/mcp-server). + + + ## **Prerequisites** ⭐ Before you begin, ensure you have met the following requirements: diff --git a/ui-kit/react-native/overview.mdx b/ui-kit/react-native/overview.mdx index 3008f688a..bb03b35ad 100644 --- a/ui-kit/react-native/overview.mdx +++ b/ui-kit/react-native/overview.mdx @@ -13,7 +13,7 @@ description: "Prebuilt React Native components for chat, voice, and video callin | Calling | Optional — `@cometchat/calls-sdk-react-native` | | Localization | Built-in localization support | | Source | [GitHub](https://github.com/cometchat/cometchat-uikit-react-native/tree/v5) | -| AI Skills | `npx @cometchat/skills add` — [GitHub](https://github.com/cometchat/cometchat-skills) | +| AI Skills | `npx @cometchat/skills add` — [Agent Skills](/agent-skills) | @@ -37,7 +37,7 @@ Auth Key is for development/testing only. In production, generate Auth Tokens on Use [CometChat Skills](https://github.com/cometchat/cometchat-skills) to add chat to any React Native 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. -Works with Claude Code, Cursor, Codex, VS Code Copilot, Windsurf, Cline, Kiro, and [30+ more agents](https://github.com/cometchat/cometchat-skills). +Works with Claude Code, Cursor, Codex, GitHub Copilot, Kiro, Replit Agent, Gemini, Windsurf, Cline, Continue, and Aider — see the [full list](/agent-skills#supported-agents). ```bash npx @cometchat/skills add @@ -64,6 +64,38 @@ After the first integration, re-run `/cometchat` anytime to pick from the iterat - **Set up push notifications** — APNs + FCM end-to-end - **Run diagnostics** — verify, drift detection, symptom-to-cause lookup + + +For deeper component customization (custom views, SDK events, request builders), connect the **CometChat Docs MCP** so your agent reads the current docs instead of guessing at APIs: + +**Claude Code:** +```bash +claude mcp add --transport http cometchat-docs https://mcp.cometchat.com/mcp +``` + +**Cursor** (`.cursor/mcp.json`): +```json +{ "mcpServers": { "cometchat-docs": { "url": "https://mcp.cometchat.com/mcp" } } } +``` + +**Windsurf (Devin Desktop):** +```json +{ "mcpServers": { "cometchat-docs": { "url": "https://mcp.cometchat.com/mcp" } } } +``` + +No authentication required. `npx @cometchat/skills add` wires this up automatically for Claude Code, Cursor, Gemini, and Codex (pass `--no-mcp` to skip it) — add it by hand only for the other agents. For Claude Desktop, VS Code, and Codex, see [MCP Integration](/mcp-server). + + + + + + Install, supported platforms, credentials, and the full skill list + + + Connect the Docs MCP to Claude, Cursor, VS Code, Codex, and Windsurf + + + --- ## Get Started diff --git a/ui-kit/react/overview.mdx b/ui-kit/react/overview.mdx index ae7935a47..c185a3388 100644 --- a/ui-kit/react/overview.mdx +++ b/ui-kit/react/overview.mdx @@ -14,6 +14,7 @@ description: "Prebuilt React components for chat, voice, and video calling. Supp | SSR | SSR-safe — no browser APIs at module scope. Next.js App Router compatible. | | Localization | 19 languages built-in | | Source | [GitHub](https://github.com/cometchat/cometchat-uikit-react/tree/v7) | +| AI Skills | `npx @cometchat/skills add` — [Agent Skills](/agent-skills) | @@ -25,6 +26,70 @@ The CometChat React UI Kit provides prebuilt, customizable components for adding --- +## Integrate with AI Coding Agents + +Use [CometChat Agent Skills](/agent-skills) to add chat to any React project through your AI coding agent. The skills take 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. The React skills target **React UI Kit v7** and cover Vite, Create React App, Next.js, React Router, and Astro. + +Works with Claude Code, Cursor, Codex, GitHub Copilot, Kiro, Replit Agent, Gemini, Windsurf, Cline, Continue, and Aider — see the [full list](/agent-skills#supported-agents). + +```bash +npx @cometchat/skills add +``` + +Use `--ide ` to target a specific agent (e.g. `--ide cursor`), or `--ide all` to install for every supported agent. + +Then in your agent: + +``` +/cometchat add chat to my app +``` + +The skills detect your framework, router, env prefix, and existing auth system. They onboard you to CometChat directly in the terminal — signup, login, and app creation all via the CLI with no browser round-trip. They read your routes, nav, and components before proposing a placement, show the plan (which files they will create, modify, and leave untouched), and wait for your approval before writing code. Credentials land in `.env` (`.env.local` for Next.js) with your bundler's prefix. + +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 + + + +For deeper component customization (custom views, SDK events, request builders), connect the **CometChat Docs MCP** so your agent reads the current docs instead of guessing at APIs: + +**Claude Code:** +```bash +claude mcp add --transport http cometchat-docs https://mcp.cometchat.com/mcp +``` + +**Cursor** (`.cursor/mcp.json`): +```json +{ "mcpServers": { "cometchat-docs": { "url": "https://mcp.cometchat.com/mcp" } } } +``` + +**Windsurf (Devin Desktop):** +```json +{ "mcpServers": { "cometchat-docs": { "url": "https://mcp.cometchat.com/mcp" } } } +``` + +No authentication required. `npx @cometchat/skills add` wires this up automatically for Claude Code, Cursor, Gemini, and Codex (pass `--no-mcp` to skip it) — add it by hand only for the other agents. For Claude Desktop, VS Code, and Codex, see [MCP Integration](/mcp-server). + + + + + + Install, supported platforms, credentials, and the full skill list + + + Connect the Docs MCP to Claude, Cursor, VS Code, Codex, and Windsurf + + + +--- + ## Try It diff --git a/ui-kit/react/v6/overview.mdx b/ui-kit/react/v6/overview.mdx index 06d418145..361f723a5 100644 --- a/ui-kit/react/v6/overview.mdx +++ b/ui-kit/react/v6/overview.mdx @@ -79,7 +79,7 @@ claude mcp add --transport http cometchat-docs https://mcp.cometchat.com/mcp { "mcpServers": { "cometchat-docs": { "url": "https://mcp.cometchat.com/mcp" } } } ``` -No authentication required. Not needed for the initial integration — the skill handles it without the MCP. For VS Code, Codex, and Claude, see [MCP Integration](/mcp-server). +No authentication required. `npx @cometchat/skills add` wires this up automatically for Claude Code, Cursor, Gemini, and Codex (pass `--no-mcp` to skip it) — add it by hand only for the other agents. For Claude Desktop, VS Code, and Codex, see [MCP Integration](/mcp-server). diff --git a/ui-kit/vue/overview.mdx b/ui-kit/vue/overview.mdx index 58be40116..81facedff 100644 --- a/ui-kit/vue/overview.mdx +++ b/ui-kit/vue/overview.mdx @@ -5,6 +5,29 @@ description: "Use CometChat Vue UI Kit to add prebuilt chat components, messagin CometChat's **UI Kit** for Vue, you can easily built an chat app with all the essential messaging feature along with the customisations and so on as per your application needs. This **UI Kit** is a set of prebuilt UI components divided into smaller modules and components and each and every component is configurable to suit your need. + + +Connect the **CometChat Docs MCP** so your AI coding agent reads CometChat's current documentation instead of guessing at APIs: + +**Claude Code:** +```bash +claude mcp add --transport http cometchat-docs https://mcp.cometchat.com/mcp +``` + +**Cursor** (`.cursor/mcp.json`): +```json +{ "mcpServers": { "cometchat-docs": { "url": "https://mcp.cometchat.com/mcp" } } } +``` + +**Windsurf (Devin Desktop):** +```json +{ "mcpServers": { "cometchat-docs": { "url": "https://mcp.cometchat.com/mcp" } } } +``` + +No authentication required. The server is read-only. For Claude Desktop, VS Code, and Codex, see [MCP Integration](/mcp-server). + + + *** ## What's New From 2669502354d831f3a5395030d92333178e89b60b Mon Sep 17 00:00:00 2001 From: "Ketan (CometChat)" Date: Wed, 23 Sep 2026 18:28:12 +0530 Subject: [PATCH 3/4] docs(ai): unify agent guidance across UI Kits, retire orphaned Kotlin overview Follow-up to the platform rollout, fixing three regressions that commit introduced plus one long-standing inaccuracy. - Normalise the "30+ more agents" claim in all 16 places, not just the two current overviews touched earlier. Neither agent-skills.mdx nor the cometchat-skills README supports "30+"; the half-done state left the iOS overview and the iOS getting-started guide disagreeing one click apart. All now name the 11 documented agents and link to /agent-skills#supported-agents. - Add the push-notifications bullet to the React v7, Angular and iOS iteration menus. agent-skills.mdx:188-193 lists a `push` skill for all six platforms, so three pages advertising push and three not was arbitrary. - Correct the iOS credentials file to `Secrets.xcconfig`, matching agent-skills.mdx:146; the page said "Secrets.swift or .xcconfig". - Delete ui-kit/kotlin/overview.mdx and redirect it to /ui-kit/android/getting-started-kotlin. The page is absent from docs.json navigation, has no redirect, and documents a v3-era kit superseded by the Kotlin and Jetpack getting-started guides. The redirect keeps the live URL and its three inbound links working. Verified: every changed .mdx compiles under @mdx-js/mdx; every internal link and heading anchor in the PR resolves; the docs.json diff is the single new redirect, with all 49 U+200E version-label marks intact. --- docs.json | 4 + ui-kit/android/v5/getting-started.mdx | 2 +- ui-kit/android/v5/overview.mdx | 2 +- ui-kit/angular/overview.mdx | 1 + ui-kit/angular/v4/getting-started.mdx | 2 +- ui-kit/angular/v4/overview.mdx | 2 +- ui-kit/flutter/v5/getting-started.mdx | 2 +- ui-kit/flutter/v5/overview.mdx | 2 +- ui-kit/ios/getting-started.mdx | 2 +- ui-kit/ios/overview.mdx | 3 +- ui-kit/kotlin/overview.mdx | 350 ------------------ ui-kit/react-native/expo-integration.mdx | 2 +- .../react-native-cli-integration.mdx | 2 +- ui-kit/react/overview.mdx | 1 + ui-kit/react/v6/astro-integration.mdx | 2 +- ui-kit/react/v6/next-js-integration.mdx | 2 +- ui-kit/react/v6/overview.mdx | 2 +- ui-kit/react/v6/react-js-integration.mdx | 2 +- ui-kit/react/v6/react-router-integration.mdx | 2 +- 19 files changed, 22 insertions(+), 365 deletions(-) delete mode 100644 ui-kit/kotlin/overview.mdx diff --git a/docs.json b/docs.json index 2ee65ea2a..3361e3a9e 100644 --- a/docs.json +++ b/docs.json @@ -10582,6 +10582,10 @@ { "source": "/ui-kit/react/v7/troubleshooting", "destination": "/ui-kit/react/troubleshooting" + }, + { + "source": "/ui-kit/kotlin/overview", + "destination": "/ui-kit/android/getting-started-kotlin" } ], "seo": { diff --git a/ui-kit/android/v5/getting-started.mdx b/ui-kit/android/v5/getting-started.mdx index 6d6945055..5e5288e0e 100644 --- a/ui-kit/android/v5/getting-started.mdx +++ b/ui-kit/android/v5/getting-started.mdx @@ -48,7 +48,7 @@ The skill detects your Android project structure, build system (Gradle/Kotlin DS After the first integration, re-run `/cometchat` to access the iteration menu: theme presets, 40+ features, component customization, production auth, user management, and diagnostics. -Works with Claude Code, Cursor, Codex, VS Code Copilot, Windsurf, Cline, Kiro, and [30+ more agents](https://github.com/cometchat/cometchat-skills). +Works with Claude Code, Cursor, Codex, GitHub Copilot, Kiro, Replit Agent, Gemini, Windsurf, Cline, Continue, and Aider — see the [full list](/agent-skills#supported-agents). --- diff --git a/ui-kit/android/v5/overview.mdx b/ui-kit/android/v5/overview.mdx index 7546972f8..67f652d5e 100644 --- a/ui-kit/android/v5/overview.mdx +++ b/ui-kit/android/v5/overview.mdx @@ -33,7 +33,7 @@ The CometChat Android UI Kit provides prebuilt, customizable Views for adding ch Use [CometChat Skills](https://github.com/cometchat/cometchat-skills) to add chat to any Android 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. -Works with Claude Code, Cursor, Codex, VS Code Copilot, Windsurf, Cline, Kiro, and [30+ more agents](https://github.com/cometchat/cometchat-skills). +Works with Claude Code, Cursor, Codex, GitHub Copilot, Kiro, Replit Agent, Gemini, Windsurf, Cline, Continue, and Aider — see the [full list](/agent-skills#supported-agents). ```bash npx @cometchat/skills add diff --git a/ui-kit/angular/overview.mdx b/ui-kit/angular/overview.mdx index 72c0ca02f..4c40cbc4a 100644 --- a/ui-kit/angular/overview.mdx +++ b/ui-kit/angular/overview.mdx @@ -53,6 +53,7 @@ After the first integration, re-run `/cometchat` anytime to pick from the iterat - **Customize a component** — custom message bubbles, headers, composer actions, empty/loading states - **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 +- **Set up push notifications** — Web Push end-to-end - **Run diagnostics** — verify, drift detection, symptom-to-cause lookup diff --git a/ui-kit/angular/v4/getting-started.mdx b/ui-kit/angular/v4/getting-started.mdx index ff4685309..9a4b5cd60 100644 --- a/ui-kit/angular/v4/getting-started.mdx +++ b/ui-kit/angular/v4/getting-started.mdx @@ -45,7 +45,7 @@ The skill detects your Angular version, router setup, and existing auth system. After the first integration, re-run `/cometchat` to access the iteration menu: theme presets, 40+ features, component customization, production auth, user management, and diagnostics. -Works with Claude Code, Cursor, Codex, VS Code Copilot, Windsurf, Cline, Kiro, and [30+ more agents](https://github.com/cometchat/cometchat-skills). +Works with Claude Code, Cursor, Codex, GitHub Copilot, Kiro, Replit Agent, Gemini, Windsurf, Cline, Continue, and Aider — see the [full list](/agent-skills#supported-agents). --- diff --git a/ui-kit/angular/v4/overview.mdx b/ui-kit/angular/v4/overview.mdx index 7c6c6b855..51cfc2d13 100644 --- a/ui-kit/angular/v4/overview.mdx +++ b/ui-kit/angular/v4/overview.mdx @@ -41,7 +41,7 @@ To begin, please follow the [Getting Started](/ui-kit/angular/v4/getting-started Use [CometChat Skills](https://github.com/cometchat/cometchat-skills) to add chat to any Angular 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. -Works with Claude Code, Cursor, Codex, VS Code Copilot, Windsurf, Cline, Kiro, and [30+ more agents](https://github.com/cometchat/cometchat-skills). +Works with Claude Code, Cursor, Codex, GitHub Copilot, Kiro, Replit Agent, Gemini, Windsurf, Cline, Continue, and Aider — see the [full list](/agent-skills#supported-agents). ```bash npx @cometchat/skills add diff --git a/ui-kit/flutter/v5/getting-started.mdx b/ui-kit/flutter/v5/getting-started.mdx index d3df5a6b5..f892eaf97 100644 --- a/ui-kit/flutter/v5/getting-started.mdx +++ b/ui-kit/flutter/v5/getting-started.mdx @@ -47,7 +47,7 @@ The skill detects your Flutter project structure, navigation setup, and existing After the first integration, re-run `/cometchat` to access the iteration menu: theme presets, 40+ features, component customization, production auth, user management, and diagnostics. -Works with Claude Code, Cursor, Codex, VS Code Copilot, Windsurf, Cline, Kiro, and [30+ more agents](https://github.com/cometchat/cometchat-skills). +Works with Claude Code, Cursor, Codex, GitHub Copilot, Kiro, Replit Agent, Gemini, Windsurf, Cline, Continue, and Aider — see the [full list](/agent-skills#supported-agents). --- diff --git a/ui-kit/flutter/v5/overview.mdx b/ui-kit/flutter/v5/overview.mdx index 88d3f18ad..32d7efe71 100644 --- a/ui-kit/flutter/v5/overview.mdx +++ b/ui-kit/flutter/v5/overview.mdx @@ -34,7 +34,7 @@ The CometChat Flutter UI Kit provides prebuilt, customizable widgets for adding Use [CometChat Skills](https://github.com/cometchat/cometchat-skills) to add chat to any Flutter 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. -Works with Claude Code, Cursor, Codex, VS Code Copilot, Windsurf, Cline, Kiro, and [30+ more agents](https://github.com/cometchat/cometchat-skills). +Works with Claude Code, Cursor, Codex, GitHub Copilot, Kiro, Replit Agent, Gemini, Windsurf, Cline, Continue, and Aider — see the [full list](/agent-skills#supported-agents). ```bash npx @cometchat/skills add diff --git a/ui-kit/ios/getting-started.mdx b/ui-kit/ios/getting-started.mdx index b9abeb260..16ad23299 100644 --- a/ui-kit/ios/getting-started.mdx +++ b/ui-kit/ios/getting-started.mdx @@ -49,7 +49,7 @@ The skill detects your iOS project structure, navigation pattern (UIKit or Swift After the first integration, re-run `/cometchat` to access the iteration menu: theme presets, 40+ features, component customization, production auth, user management, and diagnostics. -Works with Claude Code, Cursor, Codex, VS Code Copilot, Windsurf, Cline, Kiro, and [30+ more agents](https://github.com/cometchat/cometchat-skills). +Works with Claude Code, Cursor, Codex, GitHub Copilot, Kiro, Replit Agent, Gemini, Windsurf, Cline, Continue, and Aider — see the [full list](/agent-skills#supported-agents). --- diff --git a/ui-kit/ios/overview.mdx b/ui-kit/ios/overview.mdx index c9991e653..c3fe0fd94 100644 --- a/ui-kit/ios/overview.mdx +++ b/ui-kit/ios/overview.mdx @@ -71,7 +71,7 @@ Then in your IDE: /cometchat add chat to my app ``` -The skill detects your iOS project structure, navigation pattern, and existing auth system. It onboards you to CometChat directly in the terminal — signup, login, and app creation all via the CLI. It reads your view controllers, navigation, 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. Credentials are saved via `Secrets.swift` or `.xcconfig`. +The skill detects your iOS project structure, navigation pattern, and existing auth system. It onboards you to CometChat directly in the terminal — signup, login, and app creation all via the CLI. It reads your view controllers, navigation, 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. Credentials are saved in `Secrets.xcconfig`. After the first integration, re-run `/cometchat` anytime to pick from the iteration menu: @@ -80,6 +80,7 @@ After the first integration, re-run `/cometchat` anytime to pick from the iterat - **Customize a component** — custom message bubbles, headers, composer actions, empty/loading states - **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 +- **Set up push notifications** — APNs end-to-end - **Run diagnostics** — verify, drift detection, symptom-to-cause lookup diff --git a/ui-kit/kotlin/overview.mdx b/ui-kit/kotlin/overview.mdx deleted file mode 100644 index 1f41956b4..000000000 --- a/ui-kit/kotlin/overview.mdx +++ /dev/null @@ -1,350 +0,0 @@ ---- -title: "Overview" -description: "Overview of Overview in CometChat." ---- - -The CometChat Kotlin Chat UI Kit lets Android developers integrate fully featured text chat & voice/video calling into mobile apps seamlessly. - - - - - - -Improvements in v3.0 - -* Faster connection & response times -* Higher rate limits -* Supports up to 100K users in a group -* Unlimited groups -* Support for Transient Messages -* Real-time user & group members count And more! - - - -The Kotlin Chat UI Kit’s fully customizable UI components simplify the process of integrating text chat and voice/video calling features to your Android mobile application. - - - - -Follow the steps mentioned in the `README.md` file. - -Kindly, click on below button to download our Android Kotlin Chat UI Kit. - -[Kotlin Chat UI Kit](https://github.com/cometchat/cometchat-uikit-android/tree/v3) - -[View on Github](https://github.com/cometchat/cometchat-uikit-android/tree/v3) - - - - -Import the app into Android Studio and follow the steps mentioned in the `README.md` file. - -Kindly, click on below button to download our Java Sample App. - -[Kotlin Sample App](https://github.com/cometchat-pro/android-kotlin-chat-app/archive/v3.zip) - -[View on Github](https://github.com/cometchat-pro/android-kotlin-chat-app/tree/v3) - - - - - -Connect the **CometChat Docs MCP** so your AI coding agent reads CometChat's current documentation instead of guessing at APIs: - -**Claude Code:** -```bash -claude mcp add --transport http cometchat-docs https://mcp.cometchat.com/mcp -``` - -**Cursor** (`.cursor/mcp.json`): -```json -{ "mcpServers": { "cometchat-docs": { "url": "https://mcp.cometchat.com/mcp" } } } -``` - -**Windsurf (Devin Desktop):** -```json -{ "mcpServers": { "cometchat-docs": { "url": "https://mcp.cometchat.com/mcp" } } } -``` - -No authentication required. The server is read-only. For Claude Desktop, VS Code, and Codex, see [MCP Integration](/mcp-server). - - - -## **Prerequisites** ⭐ - -Before you begin, ensure you have met the following requirements: - -✅ You have Android Studio installed on your machine. - -✅ You have an Android Device or Emulator with Android Version 6.0 or above. - -✅ You have read [Key Concepts](/ui-kit/kotlin/key-concepts). - -## **Installing Android Kotlin Chat UI Kit** - -### **Setup** 🔧 - -To install Android Kotlin UI Kit, you need to first register on CometChat Dashboard. [Click here to sign up.](https://app.cometchat.com/login) - -#### **Get your Application Keys** 🔑 - -* Create a new app -* Head over to the Quick Start or API & Auth Keys section and note the App ID, Auth Key, and Region. - - - - - -#### **Add the CometChat Dependency** - -First, add the repository URL to the **project level**`build.gradle` file in the repositories block under the `allprojects` section. - - - -```gradle -allprojects { - repositories { - maven { - url "https://dl.cloudsmith.io/public/cometchat/cometchat-pro-android/maven/" - } - } -} -``` - - - - - -Open the **app level** `build.gradle` file and - -1. Add the below two line in the `dependencies` section. - - - -```gradle -dependencies { - implementation 'com.cometchat:pro-android-chat-sdk:3.0.0' - - /*v2.4+ onwards, Voice & Video Calling functionality has been - moved to a separate library. In case you plan to use the calling feature, - please add the Calling dependency*/ - - implementation 'com.cometchat:pro-android-calls-sdk:2.1.0' -} -``` - - - - - -2. Add the below lines `android` section - - - -```gradle -android { - compileOptions { - sourceCompatibility JavaVersion.VERSION_1_8 - targetCompatibility JavaVersion.VERSION_1_8 - } -} -``` - - - - - -You can refer to the below link for instructions on how to do so: - -**[📝 Add CometChat Dependency](/sdk/android/setup)** `Documentation` - -### **Configure CometChat inside your app** - -#### **Initialize CometChat** 🌟 - -The `init()` method initializes the settings required for CometChat. Please make sure to call this method before calling any other methods from CometChat SDK. - - - -```kotlin -private val appID = "APP_ID" -private val region = "REGION" -val appSettings = AppSettingsBuilder().subscribePresenceForAllUsers().setRegion(region).build() - -CometChat.init(this, appID, appSettings, object : CallbackListener() { - override fun onSuccess(successMessage: String) { - Log.d(TAG, "Initialization completed successfully") - } - - override fun onError(e: CometChatException) { - Log.d(TAG, "Initialization failed with exception: "+e.message) - } -}) -``` - - - - - - - -Make sure you replace the APP\_ID with your CometChat APP ID and REGION with your app's REGION in the above code. - - - -#### **Login User** 👤 - -The `login()` method returns the User object containing all the information of the logged-in user. - - - -```kotlin -private val UID = "cometchat-uid-1" // Replace with the UID of the user to login -private val AUTH_KEY = "Enter AUTH_KEY" // Replace with your App Auth Key -CometChat.login(UID, AUTH_KEY, object : CallbackListener() { - override fun onSuccess(user: User?) { - Log.d(TAG, "Login Successful : "+user.toString()) - } - - override fun onError(e: CometChatException) { - Log.d(TAG, "Login failed with exception: " + e.message); - } -}) -``` - - - - - - - -Make sure you replace the AUTH\_KEY with your CometChat AUTH Key in the above code. We have setup 5 users for testing having UIDs: cometchat-uid-1, cometchat-uid-2, cometchat-uid-3, cometchat-uid-4 and cometchat-uid-5. - - - -### **Add the Android Kotlin UI Kit Library** - -To integrate the UI Kit, please follow the steps below: - -* Clone the UI Kit-Kotlin Library from the [android-kotlin-chat-ui-kit](https://github.com/cometchat/cometchat-uikit-android/tree/v3) repository - -[Kotlin Download Kotlin UI Kit Library](https://github.com/cometchat/cometchat-uikit-android/tree/v3) - -* Import `uikit-kotlin` Module from Module Settings -* If the Library is added successfully, it will look like mentioned in the below image. - - - - - -### **Configure Kotlin UI Kit Library** - -To use UI Kit you have to add Material Design support in your app as the UI Kit uses Material Design Components. - -* Add Material Design Dependency in build.gradle - - - -```gradle -dependencies { - implementation 'com.google.android.material:material:' -} -``` - - - - - -* Make sure that your app's theme should extend `Theme.MaterialComponents`. Follow the guide on [Getting started Material Components](https://material.io/develop/android/docs/getting-started/) - -The following is the list of Material Components themes you can use to get the latest component styles and theme-level attributes. - -* `Theme.MaterialComponents.NoActionBar` -* Theme.MaterialComponents.Light.NoActionBar -* Theme.MaterialComponents.DayNight.NoActionBar - -Update your app theme to inherit from one of these themes, e.g.: - - - -```xml - -``` - - - - - - -Enable DataBinding - -As the UI Kit uses DataBinding you must enable DataBinding - - - -To configure your app to use data binding, add the dataBinding element to your `build.gradle` file in the app module, as shown in the following example: - - - -```gradle -android { - dataBinding { - enabled = true - } -} -``` - - - - - - -important - -We are using File Provider for storage & file access. So you need to add your application package name in manifestPlaceholders - - - - - -```gradle -android { - defaultConfig { - ... - - manifestPlaceholders = [file_provider: "YOUR_PACKAGE_NAME"] - //add your application package. - } - } -``` - - - - - -### **Launch CometChatUI** 🚀 - - - - - -**CometChatUI** is an option to launch a fully functional chat application using the UI Kit. In UI Kit all the UI Components are interlinked and work together to launch a fully functional chat on your mobile/application. - -To use CometChatUI user has to launch CometChatUI Activity. Add the following code snippet to launch `CometChatUI`. - - - -```kotlin -startActivity(Intent(this@YourActivity, CometChatUI::class.java)) -``` - - - - - -## **See our Kotlin chat sample app** - -Visit our [Kotlin chat app](https://github.com/cometchat-pro/android-kotlin-chat-app) repository to run a sample app and see the UI Kit in action. diff --git a/ui-kit/react-native/expo-integration.mdx b/ui-kit/react-native/expo-integration.mdx index 7cab22bc9..76b9b482e 100644 --- a/ui-kit/react-native/expo-integration.mdx +++ b/ui-kit/react-native/expo-integration.mdx @@ -48,7 +48,7 @@ The skill detects your Expo setup (managed workflow + Expo Router), env prefix ( After the first integration, re-run `/cometchat` to access the iteration menu: theme presets, 40+ features, component customization, push notifications, production auth, user management, and diagnostics. -Works with Claude Code, Cursor, Codex, VS Code Copilot, Windsurf, Cline, Kiro, and [30+ more agents](https://github.com/cometchat/cometchat-skills). +Works with Claude Code, Cursor, Codex, GitHub Copilot, Kiro, Replit Agent, Gemini, Windsurf, Cline, Continue, and Aider — see the [full list](/agent-skills#supported-agents). --- diff --git a/ui-kit/react-native/react-native-cli-integration.mdx b/ui-kit/react-native/react-native-cli-integration.mdx index 7271525c9..56874bff8 100644 --- a/ui-kit/react-native/react-native-cli-integration.mdx +++ b/ui-kit/react-native/react-native-cli-integration.mdx @@ -44,7 +44,7 @@ The skill detects your React Native setup, navigation library, and existing auth After the first integration, re-run `/cometchat` to access the iteration menu: theme presets, 40+ features, component customization, push notifications, production auth, user management, and diagnostics. -Works with Claude Code, Cursor, Codex, VS Code Copilot, Windsurf, Cline, Kiro, and [30+ more agents](https://github.com/cometchat/cometchat-skills). +Works with Claude Code, Cursor, Codex, GitHub Copilot, Kiro, Replit Agent, Gemini, Windsurf, Cline, Continue, and Aider — see the [full list](/agent-skills#supported-agents). --- diff --git a/ui-kit/react/overview.mdx b/ui-kit/react/overview.mdx index c185a3388..dc481995b 100644 --- a/ui-kit/react/overview.mdx +++ b/ui-kit/react/overview.mdx @@ -54,6 +54,7 @@ After the first integration, re-run `/cometchat` anytime to pick from the iterat - **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 +- **Set up push notifications** — Web Push end-to-end - **Run diagnostics** — verify, drift detection, symptom-to-cause lookup diff --git a/ui-kit/react/v6/astro-integration.mdx b/ui-kit/react/v6/astro-integration.mdx index b27e7a677..09182ed72 100644 --- a/ui-kit/react/v6/astro-integration.mdx +++ b/ui-kit/react/v6/astro-integration.mdx @@ -50,7 +50,7 @@ The skill detects Astro, verifies `@astrojs/react` is configured, and reads your After the first integration, re-run `/cometchat` to access the iteration menu: theme presets, 40+ features, component customization, floating widget, production auth, user management, and diagnostics. -Works with Claude Code, Cursor, Codex, VS Code Copilot, Windsurf, Cline, Kiro, and [30+ more agents](https://github.com/cometchat/cometchat-skills). +Works with Claude Code, Cursor, Codex, GitHub Copilot, Kiro, Replit Agent, Gemini, Windsurf, Cline, Continue, and Aider — see the [full list](/agent-skills#supported-agents). --- diff --git a/ui-kit/react/v6/next-js-integration.mdx b/ui-kit/react/v6/next-js-integration.mdx index 8ed0cdeef..6a1461fef 100644 --- a/ui-kit/react/v6/next-js-integration.mdx +++ b/ui-kit/react/v6/next-js-integration.mdx @@ -54,7 +54,7 @@ The skill detects your Next.js version and router type (App Router vs Pages Rout After the first integration, re-run `/cometchat` to access the iteration menu: theme presets, 40+ features, component customization, floating widget, production auth, user management, and diagnostics. -Works with Claude Code, Cursor, Codex, VS Code Copilot, Windsurf, Cline, Kiro, and [30+ more agents](https://github.com/cometchat/cometchat-skills). +Works with Claude Code, Cursor, Codex, GitHub Copilot, Kiro, Replit Agent, Gemini, Windsurf, Cline, Continue, and Aider — see the [full list](/agent-skills#supported-agents). --- diff --git a/ui-kit/react/v6/overview.mdx b/ui-kit/react/v6/overview.mdx index 361f723a5..9b375997e 100644 --- a/ui-kit/react/v6/overview.mdx +++ b/ui-kit/react/v6/overview.mdx @@ -34,7 +34,7 @@ The CometChat React UI Kit provides prebuilt, customizable components for adding 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). +Works with Claude Code, Cursor, Codex, GitHub Copilot, Kiro, Replit Agent, Gemini, Windsurf, Cline, Continue, and Aider — see the [full list](/agent-skills#supported-agents). ```bash npx @cometchat/skills add diff --git a/ui-kit/react/v6/react-js-integration.mdx b/ui-kit/react/v6/react-js-integration.mdx index 6779546e6..60ee2e741 100644 --- a/ui-kit/react/v6/react-js-integration.mdx +++ b/ui-kit/react/v6/react-js-integration.mdx @@ -49,7 +49,7 @@ The skill detects your bundler (Vite or CRA), env prefix (`VITE_` or `REACT_APP_ After the first integration, re-run `/cometchat` to access the iteration menu: theme presets, 40+ features, component customization, floating widget, production auth, user management, and diagnostics. -Works with Claude Code, Cursor, Codex, VS Code Copilot, Windsurf, Cline, Kiro, and [30+ more agents](https://github.com/cometchat/cometchat-skills). +Works with Claude Code, Cursor, Codex, GitHub Copilot, Kiro, Replit Agent, Gemini, Windsurf, Cline, Continue, and Aider — see the [full list](/agent-skills#supported-agents). --- diff --git a/ui-kit/react/v6/react-router-integration.mdx b/ui-kit/react/v6/react-router-integration.mdx index b7d80b51c..c972000d5 100644 --- a/ui-kit/react/v6/react-router-integration.mdx +++ b/ui-kit/react/v6/react-router-integration.mdx @@ -50,7 +50,7 @@ The skill detects your React Router version (v6 or v7), env prefix, router setup After the first integration, re-run `/cometchat` to access the iteration menu: theme presets, 40+ features, component customization, floating widget, production auth, user management, and diagnostics. -Works with Claude Code, Cursor, Codex, VS Code Copilot, Windsurf, Cline, Kiro, and [30+ more agents](https://github.com/cometchat/cometchat-skills). +Works with Claude Code, Cursor, Codex, GitHub Copilot, Kiro, Replit Agent, Gemini, Windsurf, Cline, Continue, and Aider — see the [full list](/agent-skills#supported-agents). --- From 6a9ad5345693560e5e08a2f0320fb6530f4e2c73 Mon Sep 17 00:00:00 2001 From: "Ketan (CometChat)" Date: Wed, 23 Sep 2026 19:00:05 +0530 Subject: [PATCH 4/4] docs(sdk/android): fix malformed url frontmatter on the Kotlin UI Kit stub sdk/android/3.0/kotlin-overview.mdx is a nav entry whose entire content is a `url:` frontmatter pointer. The value was unquoted, carried a stray trailing quote and a /docs/ prefix, which sent readers to a 404 on production: https://www.cometchat.com/docs/sdk/android/3.0/kotlin-overview -> 307 -> https://www.cometchat.com/docs/docs/ui-kit/kotlin/overview" It now points at /ui-kit/android/getting-started-kotlin, quoted, matching the other 58 internal `url:` values in the repo. Pointing at the live target rather than the redirect this PR adds avoids a needless hop. This was the last malformed `url:` frontmatter on the site. --- sdk/android/3.0/kotlin-overview.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sdk/android/3.0/kotlin-overview.mdx b/sdk/android/3.0/kotlin-overview.mdx index 1daa48965..041a9ecde 100644 --- a/sdk/android/3.0/kotlin-overview.mdx +++ b/sdk/android/3.0/kotlin-overview.mdx @@ -1,5 +1,5 @@ --- title: "Android Kotlin UI Kit" -url: /docs/ui-kit/kotlin/overview" +url: "/ui-kit/android/getting-started-kotlin" description: "Overview of Android Kotlin UI Kit in CometChat." --- \ No newline at end of file