From e6ef700d3800bc09eaf3f4db8cd00fe75519c5c9 Mon Sep 17 00:00:00 2001 From: amitthacker Date: Mon, 26 Oct 2026 16:33:25 +0530 Subject: [PATCH 1/4] Docs: add the entry-point snippet snippets/entry-point.mdx is one line with one link to the Start-here guide for the stack of the page it sits on, tagged utm_source=docs, utm_medium=entry and utm_campaign set to the docs section. One file, so the wording changes in one place. No page uses it yet; the next commit adds it under the H1 of the top 20 docs pages. Co-Authored-By: Claude Opus 5.5 --- snippets/entry-point.mdx | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) create mode 100644 snippets/entry-point.mdx diff --git a/snippets/entry-point.mdx b/snippets/entry-point.mdx new file mode 100644 index 000000000..7a75db02e --- /dev/null +++ b/snippets/entry-point.mdx @@ -0,0 +1,27 @@ +{/* + The docs entry point: one line under the H1, one link to the Start-here guide for the + stack of the page it sits on. The wording lives here and nowhere else, so it changes in + one place (task T-docs-entry.05). + + Props + stack the stack's name, for example "React". Leave it out on a page with no single + stack; the line then points at the page where a reader picks one. + href the Start-here guide for that stack. + campaign the docs section the page sits in. It becomes utm_campaign. + + Every link carries utm_source=docs and utm_medium=entry, so a signup that starts on a + docs page can be counted (task T-docs-entry.07). + + JSX, not Markdown: inside an exported component, Markdown renders literally. The {' '} + keeps the space that JSX drops next to a tag. +*/} + +export const EntryPoint = ({ stack, href = "/chat-call", campaign = "docs" }) => ( +

+ New to CometChat?{' '} + + {stack ? `Start with the ${stack} integration guide` : "Pick your stack and start building"} + + . +

+); From 81bdbf985ec67fab8b81526523a6745e893588fc Mon Sep 17 00:00:00 2001 From: amitthacker Date: Mon, 26 Oct 2026 16:33:27 +0530 Subject: [PATCH 2/4] Docs: put the entry point under the H1 of the top 18 docs pages The top 20 docs pages by Search Console clicks over 90 days, less the ones that correctly get nothing (2: custom landing pages that are themselves a place to start). Each page gets one import and one line directly under its title. Nothing else on any page changed. Co-Authored-By: Claude Opus 5.5 --- fundamentals/pin-message.mdx | 4 ++++ fundamentals/webhooks.mdx | 4 ++++ mcp-server.mdx | 4 ++++ notifications/ios-fcm-push-notifications.mdx | 4 ++++ rest-api/banned-users/unban.mdx | 4 ++++ rest-api/chat-apis.mdx | 4 ++++ rest-api/messages.mdx | 4 ++++ sdk/android/edit-message.mdx | 4 ++++ sdk/javascript/3.0/messaging-edit-message.mdx | 4 ++++ ui-kit/android/guide-new-chat.mdx | 4 ++++ ui-kit/kotlin/2.0/ui-components.mdx | 4 ++++ ui-kit/react-native/message-bubble-styling.mdx | 4 ++++ ui-kit/react/components/message-composer.mdx | 4 ++++ ui-kit/react/guide-new-chat-creation.mdx | 4 ++++ ui-kit/react/next-tab-based-chat.mdx | 4 ++++ ui-kit/react/overview.mdx | 4 ++++ web-shared/localize.mdx | 4 ++++ web-shared/reactions-configuration.mdx | 4 ++++ 18 files changed, 72 insertions(+) diff --git a/fundamentals/pin-message.mdx b/fundamentals/pin-message.mdx index 944bf0354..b94630e7b 100644 --- a/fundamentals/pin-message.mdx +++ b/fundamentals/pin-message.mdx @@ -3,6 +3,10 @@ title: "Pin Message" description: "Pin, unpin, and fetch pinned CometChat messages in one-on-one or group conversations using the Pin Message extension." --- +import { EntryPoint } from "/snippets/entry-point.mdx"; + + + ## Extension settings 1. Login to [CometChat](https://app.cometchat.com/login) and select your app. diff --git a/fundamentals/webhooks.mdx b/fundamentals/webhooks.mdx index e18495f70..b75b8a4ad 100644 --- a/fundamentals/webhooks.mdx +++ b/fundamentals/webhooks.mdx @@ -4,6 +4,10 @@ sidebarTitle: "Webhooks" description: "Use CometChat webhooks to send real-time chat, user, group, call, and moderation events to your server." --- +import { EntryPoint } from "/snippets/entry-point.mdx"; + + + CometChat Webhooks enable real-time, event-driven communication with your server by sending HTTP POST requests whenever specific events occur in your chat application. ## What Are Webhooks? diff --git a/mcp-server.mdx b/mcp-server.mdx index 1f17019f3..4649a03a6 100644 --- a/mcp-server.mdx +++ b/mcp-server.mdx @@ -5,6 +5,10 @@ description: "Connect CometChat to Claude, Cursor, Windsurf, VS Code, and any ot canonical: "https://www.cometchat.com/docs/mcp-server" --- +import { EntryPoint } from "/snippets/entry-point.mdx"; + + + 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 diff --git a/notifications/ios-fcm-push-notifications.mdx b/notifications/ios-fcm-push-notifications.mdx index 4af018260..1fa91446b 100644 --- a/notifications/ios-fcm-push-notifications.mdx +++ b/notifications/ios-fcm-push-notifications.mdx @@ -3,6 +3,10 @@ title: "iOS FCM Push Notifications" description: "Guide to integrating Firebase Cloud Messaging (FCM) push notifications in iOS apps using CometChat." --- +import { EntryPoint } from "/snippets/entry-point.mdx"; + + + FCM doesn't support VoIP pushes; use APNs + PushKit for VoIP calls. diff --git a/rest-api/banned-users/unban.mdx b/rest-api/banned-users/unban.mdx index 2052be40e..d1d878521 100644 --- a/rest-api/banned-users/unban.mdx +++ b/rest-api/banned-users/unban.mdx @@ -3,4 +3,8 @@ openapi: delete /groups/{guid}/bannedusers/{uid} description: "Unban a CometChat user from a group using GUID and UID parameters to restore group access through the REST API." --- +import { EntryPoint } from "/snippets/entry-point.mdx"; + + + For the complete error reference, see [Error Guide](/articles/error-guide). diff --git a/rest-api/chat-apis.mdx b/rest-api/chat-apis.mdx index 48dacb434..a2ab7892a 100644 --- a/rest-api/chat-apis.mdx +++ b/rest-api/chat-apis.mdx @@ -3,6 +3,10 @@ title: "Overview" description: "CometChat REST API documentation for integrating chat functionality into your server-side applications." --- +import { EntryPoint } from "/snippets/entry-point.mdx"; + + + Welcome to CometChat's REST API documentation! This documentation provides detailed information on the Chat APIs offered by CometChat, a comprehensive communication platform that enables developers to integrate chat functionality into their server side applications effortlessly. ## API Resources diff --git a/rest-api/messages.mdx b/rest-api/messages.mdx index c31142f67..84cb8e1df 100644 --- a/rest-api/messages.mdx +++ b/rest-api/messages.mdx @@ -3,6 +3,10 @@ title: "Overview" description: "Send, retrieve, and manage CometChat messages with REST APIs for user and group chats, including text, media, threads, and reactions." --- +import { EntryPoint } from "/snippets/entry-point.mdx"; + + + A **Message** is the core unit of communication in CometChat. Users can send text, media files, and custom data to other users or groups. Messages support threading, reactions, read receipts, and delivery tracking. ### Key behaviors diff --git a/sdk/android/edit-message.mdx b/sdk/android/edit-message.mdx index 1ef0178ff..41d618699 100644 --- a/sdk/android/edit-message.mdx +++ b/sdk/android/edit-message.mdx @@ -4,6 +4,10 @@ sidebarTitle: "Edit Message" description: "Edit CometChat text and custom messages after sending them with the Android SDK and update message state in chats." --- +import { EntryPoint } from "/snippets/entry-point.mdx"; + + + ```kotlin diff --git a/sdk/javascript/3.0/messaging-edit-message.mdx b/sdk/javascript/3.0/messaging-edit-message.mdx index a5fd2a9eb..154e33c40 100644 --- a/sdk/javascript/3.0/messaging-edit-message.mdx +++ b/sdk/javascript/3.0/messaging-edit-message.mdx @@ -3,6 +3,10 @@ title: "Edit A Message" description: "Edit A Message — CometChat documentation." --- +import { EntryPoint } from "/snippets/entry-point.mdx"; + + + While [editing a message](/sdk/javascript/3.0/messaging-edit-message#edit-a-message) is straightforward, receiving events for edited messages with CometChat has two parts: diff --git a/ui-kit/android/guide-new-chat.mdx b/ui-kit/android/guide-new-chat.mdx index 6370344dd..b08599301 100644 --- a/ui-kit/android/guide-new-chat.mdx +++ b/ui-kit/android/guide-new-chat.mdx @@ -4,6 +4,10 @@ sidebarTitle: "New Chat" description: "Enable users to start one-on-one or group chats from a new chat screen with user and group browsing." --- +import { EntryPoint } from "/snippets/entry-point.mdx"; + + + | Field | Value | diff --git a/ui-kit/kotlin/2.0/ui-components.mdx b/ui-kit/kotlin/2.0/ui-components.mdx index 2096e00de..3b752f474 100644 --- a/ui-kit/kotlin/2.0/ui-components.mdx +++ b/ui-kit/kotlin/2.0/ui-components.mdx @@ -3,6 +3,10 @@ title: "UI Components" description: "UI Components — CometChat documentation." --- +import { EntryPoint } from "/snippets/entry-point.mdx"; + + + Version: v2 **UI Components** are building a block of the UI Kit. **UI Components** are a set of custom classes specially designed to build a feature-rich chat app. To achieve high customizability while building an app one can use the UI Components. There are different UI Components available in the UI Kit library. diff --git a/ui-kit/react-native/message-bubble-styling.mdx b/ui-kit/react-native/message-bubble-styling.mdx index 9af6489e3..717c9b811 100644 --- a/ui-kit/react-native/message-bubble-styling.mdx +++ b/ui-kit/react-native/message-bubble-styling.mdx @@ -3,6 +3,10 @@ title: "Message Bubble Styling" description: "Customize CometChat React Native UI Kit message bubbles for text, image, video, audio, file, poll, and other message types." --- +import { EntryPoint } from "/snippets/entry-point.mdx"; + + + | Field | Value | diff --git a/ui-kit/react/components/message-composer.mdx b/ui-kit/react/components/message-composer.mdx index 892cb3317..c998b56b0 100644 --- a/ui-kit/react/components/message-composer.mdx +++ b/ui-kit/react/components/message-composer.mdx @@ -3,6 +3,10 @@ title: "Message Composer" description: "Rich text input with attachments, emoji, voice recording, mentions, and formatting for sending messages." --- +import { EntryPoint } from "/snippets/entry-point.mdx"; + + + ```json { diff --git a/ui-kit/react/guide-new-chat-creation.mdx b/ui-kit/react/guide-new-chat-creation.mdx index dc98c3863..b03cbdaeb 100644 --- a/ui-kit/react/guide-new-chat-creation.mdx +++ b/ui-kit/react/guide-new-chat-creation.mdx @@ -4,6 +4,10 @@ sidebarTitle: "New Chat Creation" description: "Start new one-on-one or group conversations by selecting users or groups from a list." --- +import { EntryPoint } from "/snippets/entry-point.mdx"; + + + ## Goal By the end of this guide you will have a chat interface where users can initiate new one-on-one conversations by selecting from a user list, or start group chats by selecting from available groups — then immediately begin messaging. diff --git a/ui-kit/react/next-tab-based-chat.mdx b/ui-kit/react/next-tab-based-chat.mdx index ee8ee4c54..52691c099 100644 --- a/ui-kit/react/next-tab-based-chat.mdx +++ b/ui-kit/react/next-tab-based-chat.mdx @@ -4,6 +4,10 @@ sidebarTitle: "Tab-Based Chat" description: "Build a tab-based chat interface with Chat, Call Logs, and Users tabs in Next.js (App Router)." --- +import { EntryPoint } from "/snippets/entry-point.mdx"; + + + | Field | Value | diff --git a/ui-kit/react/overview.mdx b/ui-kit/react/overview.mdx index 0e05a1456..2600de3a9 100644 --- a/ui-kit/react/overview.mdx +++ b/ui-kit/react/overview.mdx @@ -4,6 +4,10 @@ sidebarTitle: "Overview" description: "Prebuilt React components for chat, voice, and video calling. Supports React.js, Next.js, React Router, and Astro." --- +import { EntryPoint } from "/snippets/entry-point.mdx"; + + + | Field | Value | diff --git a/web-shared/localize.mdx b/web-shared/localize.mdx index 5dd185f54..1fc8ddfef 100644 --- a/web-shared/localize.mdx +++ b/web-shared/localize.mdx @@ -3,6 +3,10 @@ title: "Localize" description: "Localize — CometChat documentation." --- +import { EntryPoint } from "/snippets/entry-point.mdx"; + + + With language localization, CometChat UI Kit adapts to the language of a specific country or region. `CometChatLocalize` allows you to detect the language of your users based on their browser settings and set the language accordingly. ## Supported languages diff --git a/web-shared/reactions-configuration.mdx b/web-shared/reactions-configuration.mdx index 4ab268095..1bffa3994 100644 --- a/web-shared/reactions-configuration.mdx +++ b/web-shared/reactions-configuration.mdx @@ -3,6 +3,10 @@ title: "ReactionsConfiguration" description: "ReactionsConfiguration — CometChat documentation." --- +import { EntryPoint } from "/snippets/entry-point.mdx"; + + + You can modify the Reaction component's properties using the ReactionsConfiguration object. To use a configuration, you simply need to pass it to respective parameter. The ReactionsConfiguration supports the following properties: From 1b2c69bd81a457fcadc5f8d8574a09d1fc372e61 Mon Sep 17 00:00:00 2001 From: amitthacker Date: Mon, 2 Nov 2026 13:19:00 +0530 Subject: [PATCH 3/4] Derive the entry link from the stack, and keep the AI summary first Addresses the review on #585. Derive href from stack. href was a pure function of stack but passed as a separate prop, so the pair was hand-copied on nine pages and had drifted on four of them. Pages now pass only stack and campaign, and the stack-to-guide map lives in the component. An unknown stack falls back to the chooser rather than throwing: a throw would be a build failure, and a build failure in a table cell is what froze five React pages on live for six weeks. Three destinations corrected, not four: - next-tab-based-chat is a Next.js App Router page and linked to the Vite/CRA guide. Now Next.js, which is the App Router guide with the client-component and SSR steps. - sdk/android/edit-message is an SDK page and linked to the Android UI Kit. Now Android SDK, which is /sdk/android/setup. - sdk/javascript/.../messaging-edit-message keeps /sdk/javascript/overview. Read both candidates: overview is titled "Overview" but its body is the full walkthrough (keys, dependency, initialize, register and login, UI Kits, widget), while setup-sdk covers only install/import/initialize and opens with a v3-to-v4 migration note. The link promises an integration guide and overview delivers it. Renamed the key to "JavaScript SDK" so the product line is explicit. The iOS notifications page keeps the chooser. The rule it broke was the rule itself: platform alone does not determine a destination, because iOS has both a UI Kit and an SDK and a notifications page is read by users of both. Sharpened the documented rule instead of the call site. Keep the AI Integration Quick Reference first on the six pages that have one. It was the first body element and the entry line displaced it, which put a marketing sentence above the structured summary that answer engines and copy-as-Markdown read first. Six pages, not the eight estimated in review. Also: campaign no longer defaults to "docs", so a page that forgets it is conspicuous rather than silently plausible; the query is inserted before any fragment, so an href with a #fragment cannot put the parameters inside it; and the sentence is one line, so the .md output no longer breaks across three lines with a lone period. Tracking is unchanged and built in one place, pending a decision on it. Co-Authored-By: Claude Opus 5 --- fundamentals/pin-message.mdx | 2 +- fundamentals/webhooks.mdx | 2 +- mcp-server.mdx | 2 +- notifications/ios-fcm-push-notifications.mdx | 2 +- rest-api/banned-users/unban.mdx | 2 +- rest-api/chat-apis.mdx | 2 +- rest-api/messages.mdx | 2 +- sdk/android/edit-message.mdx | 4 +- sdk/javascript/3.0/messaging-edit-message.mdx | 2 +- snippets/entry-point.mdx | 50 +++++++++++++------ ui-kit/android/guide-new-chat.mdx | 4 +- ui-kit/kotlin/2.0/ui-components.mdx | 2 +- .../react-native/message-bubble-styling.mdx | 4 +- ui-kit/react/components/message-composer.mdx | 4 +- ui-kit/react/guide-new-chat-creation.mdx | 2 +- ui-kit/react/next-tab-based-chat.mdx | 4 +- ui-kit/react/overview.mdx | 4 +- web-shared/localize.mdx | 2 +- web-shared/reactions-configuration.mdx | 2 +- 19 files changed, 58 insertions(+), 40 deletions(-) diff --git a/fundamentals/pin-message.mdx b/fundamentals/pin-message.mdx index b94630e7b..e673b6b4d 100644 --- a/fundamentals/pin-message.mdx +++ b/fundamentals/pin-message.mdx @@ -5,7 +5,7 @@ description: "Pin, unpin, and fetch pinned CometChat messages in one-on-one or g import { EntryPoint } from "/snippets/entry-point.mdx"; - + ## Extension settings diff --git a/fundamentals/webhooks.mdx b/fundamentals/webhooks.mdx index b75b8a4ad..85531dd78 100644 --- a/fundamentals/webhooks.mdx +++ b/fundamentals/webhooks.mdx @@ -6,7 +6,7 @@ description: "Use CometChat webhooks to send real-time chat, user, group, call, import { EntryPoint } from "/snippets/entry-point.mdx"; - + CometChat Webhooks enable real-time, event-driven communication with your server by sending HTTP POST requests whenever specific events occur in your chat application. diff --git a/mcp-server.mdx b/mcp-server.mdx index 4649a03a6..96136b9df 100644 --- a/mcp-server.mdx +++ b/mcp-server.mdx @@ -7,7 +7,7 @@ canonical: "https://www.cometchat.com/docs/mcp-server" import { EntryPoint } from "/snippets/entry-point.mdx"; - + The **CometChat MCP server** lets Claude, Cursor, Windsurf, VS Code, and any other Model Context Protocol–compatible agent integrate CometChat into your diff --git a/notifications/ios-fcm-push-notifications.mdx b/notifications/ios-fcm-push-notifications.mdx index 1fa91446b..c4bd365e4 100644 --- a/notifications/ios-fcm-push-notifications.mdx +++ b/notifications/ios-fcm-push-notifications.mdx @@ -5,7 +5,7 @@ description: "Guide to integrating Firebase Cloud Messaging (FCM) push notificat import { EntryPoint } from "/snippets/entry-point.mdx"; - + FCM doesn't support VoIP pushes; use APNs + PushKit for VoIP calls. diff --git a/rest-api/banned-users/unban.mdx b/rest-api/banned-users/unban.mdx index d1d878521..f6ed6a0d1 100644 --- a/rest-api/banned-users/unban.mdx +++ b/rest-api/banned-users/unban.mdx @@ -5,6 +5,6 @@ description: "Unban a CometChat user from a group using GUID and UID parameters import { EntryPoint } from "/snippets/entry-point.mdx"; - + For the complete error reference, see [Error Guide](/articles/error-guide). diff --git a/rest-api/chat-apis.mdx b/rest-api/chat-apis.mdx index a2ab7892a..84e887c83 100644 --- a/rest-api/chat-apis.mdx +++ b/rest-api/chat-apis.mdx @@ -5,7 +5,7 @@ description: "CometChat REST API documentation for integrating chat functionalit import { EntryPoint } from "/snippets/entry-point.mdx"; - + Welcome to CometChat's REST API documentation! This documentation provides detailed information on the Chat APIs offered by CometChat, a comprehensive communication platform that enables developers to integrate chat functionality into their server side applications effortlessly. diff --git a/rest-api/messages.mdx b/rest-api/messages.mdx index 84cb8e1df..324481b09 100644 --- a/rest-api/messages.mdx +++ b/rest-api/messages.mdx @@ -5,7 +5,7 @@ description: "Send, retrieve, and manage CometChat messages with REST APIs for u import { EntryPoint } from "/snippets/entry-point.mdx"; - + A **Message** is the core unit of communication in CometChat. Users can send text, media files, and custom data to other users or groups. Messages support threading, reactions, read receipts, and delivery tracking. diff --git a/sdk/android/edit-message.mdx b/sdk/android/edit-message.mdx index 41d618699..30e2fe503 100644 --- a/sdk/android/edit-message.mdx +++ b/sdk/android/edit-message.mdx @@ -6,8 +6,6 @@ description: "Edit CometChat text and custom messages after sending them with th import { EntryPoint } from "/snippets/entry-point.mdx"; - - ```kotlin @@ -31,6 +29,8 @@ CometChat.addMessageListener("LISTENER_ID", object : CometChat.MessageListener() ``` + + ## Edit a Message Use `editMessage()` with a [`TextMessage`](/sdk/reference/messages#textmessage) or [`CustomMessage`](/sdk/reference/messages#custommessage) object. Set the message ID using `setId()`. diff --git a/sdk/javascript/3.0/messaging-edit-message.mdx b/sdk/javascript/3.0/messaging-edit-message.mdx index 154e33c40..a7a16b4d0 100644 --- a/sdk/javascript/3.0/messaging-edit-message.mdx +++ b/sdk/javascript/3.0/messaging-edit-message.mdx @@ -5,7 +5,7 @@ description: "Edit A Message — CometChat documentation." import { EntryPoint } from "/snippets/entry-point.mdx"; - + diff --git a/snippets/entry-point.mdx b/snippets/entry-point.mdx index 7a75db02e..dfe863dbd 100644 --- a/snippets/entry-point.mdx +++ b/snippets/entry-point.mdx @@ -1,27 +1,45 @@ {/* - The docs entry point: one line under the H1, one link to the Start-here guide for the + The docs entry point: one line under the title, one link to the Start-here guide for the stack of the page it sits on. The wording lives here and nowhere else, so it changes in one place (task T-docs-entry.05). Props - stack the stack's name, for example "React". Leave it out on a page with no single - stack; the line then points at the page where a reader picks one. - href the Start-here guide for that stack. + stack a key of the guides map below. Leave it out when the page has no single stack, + or when the platform has more than one product line and the page does not say + which (a notifications page is read by both UI Kit and SDK users). The line + then points at the page where a reader picks one. campaign the docs section the page sits in. It becomes utm_campaign. + The destination is derived from stack, never passed in. An href prop would be a second + source of truth for the same fact, and when it was one the pair drifted on four of nine + pages (reviewed on #585). + + A stack that is not in the map falls back to the chooser rather than throwing. A throw + here would be a build failure, and a build failure in a table cell is what froze five + React pages on live for six weeks, so this component does not add that risk. + Every link carries utm_source=docs and utm_medium=entry, so a signup that starts on a - docs page can be counted (task T-docs-entry.07). + docs page can be counted (task T-docs-entry.07). Tracking is built in one place below, + so it comes out in one edit if that decision changes. - JSX, not Markdown: inside an exported component, Markdown renders literally. The {' '} - keeps the space that JSX drops next to a tag. + JSX, not Markdown: inside an exported component, Markdown renders literally. The sentence + stays on one line so the serialized .md output is one line too. */} -export const EntryPoint = ({ stack, href = "/chat-call", campaign = "docs" }) => ( -

- New to CometChat?{' '} - - {stack ? `Start with the ${stack} integration guide` : "Pick your stack and start building"} - - . -

-); +export const EntryPoint = ({ stack, campaign }) => { + const guides = { + "React": "/ui-kit/react/integration-react", + "Next.js": "/ui-kit/react/integration-nextjs", + "React Native": "/ui-kit/react-native/react-native-cli-integration", + "Android": "/ui-kit/android/getting-started", + "Android SDK": "/sdk/android/setup", + "JavaScript SDK": "/sdk/javascript/overview", + }; + const guide = stack ? guides[stack] : undefined; + const [path, fragment] = (guide || "/chat-call").split("#"); + const tracking = `utm_source=docs&utm_medium=entry&utm_campaign=${encodeURIComponent(campaign)}`; + const href = `${path}${path.includes("?") ? "&" : "?"}${tracking}${fragment ? `#${fragment}` : ""}`; + return ( +

New to CometChat? {guide ? `Start with the ${stack} integration guide` : "Pick your stack and start building"}.

+ ); +}; diff --git a/ui-kit/android/guide-new-chat.mdx b/ui-kit/android/guide-new-chat.mdx index b08599301..09aeb41d4 100644 --- a/ui-kit/android/guide-new-chat.mdx +++ b/ui-kit/android/guide-new-chat.mdx @@ -6,8 +6,6 @@ description: "Enable users to start one-on-one or group chats from a new chat sc import { EntryPoint } from "/snippets/entry-point.mdx"; - - | Field | Value | @@ -19,6 +17,8 @@ import { EntryPoint } from "/snippets/entry-point.mdx"; + + Enable users to start one-on-one or group chats by integrating CometChat's **New Chat** screen (`CometChatUsers` + `CometChatGroups`), providing a seamless flow from your conversation list to a specific chat. ## Overview diff --git a/ui-kit/kotlin/2.0/ui-components.mdx b/ui-kit/kotlin/2.0/ui-components.mdx index 3b752f474..7ddf5662c 100644 --- a/ui-kit/kotlin/2.0/ui-components.mdx +++ b/ui-kit/kotlin/2.0/ui-components.mdx @@ -5,7 +5,7 @@ description: "UI Components — CometChat documentation." import { EntryPoint } from "/snippets/entry-point.mdx"; - + Version: v2 diff --git a/ui-kit/react-native/message-bubble-styling.mdx b/ui-kit/react-native/message-bubble-styling.mdx index 717c9b811..ac39d8c77 100644 --- a/ui-kit/react-native/message-bubble-styling.mdx +++ b/ui-kit/react-native/message-bubble-styling.mdx @@ -5,8 +5,6 @@ description: "Customize CometChat React Native UI Kit message bubbles for text, import { EntryPoint } from "/snippets/entry-point.mdx"; - - | Field | Value | @@ -24,6 +22,8 @@ import { EntryPoint } from "/snippets/entry-point.mdx"; + + Customize message bubble appearance by passing bubble styles in `theme.messageListStyles`. diff --git a/ui-kit/react/components/message-composer.mdx b/ui-kit/react/components/message-composer.mdx index c998b56b0..34da93a4d 100644 --- a/ui-kit/react/components/message-composer.mdx +++ b/ui-kit/react/components/message-composer.mdx @@ -5,8 +5,6 @@ description: "Rich text input with attachments, emoji, voice recording, mentions import { EntryPoint } from "/snippets/entry-point.mdx"; - - ```json { @@ -138,6 +136,8 @@ import { EntryPoint } from "/snippets/entry-point.mdx"; ``` + + ## Overview `CometChatMessageComposer` is a rich text input component for sending messages. It supports attachments, emoji, voice recording, mentions, rich text formatting, and reply/edit previews. Wire it alongside `CometChatMessageList` and `CometChatMessageHeader` to build a complete messaging experience. diff --git a/ui-kit/react/guide-new-chat-creation.mdx b/ui-kit/react/guide-new-chat-creation.mdx index b03cbdaeb..425903554 100644 --- a/ui-kit/react/guide-new-chat-creation.mdx +++ b/ui-kit/react/guide-new-chat-creation.mdx @@ -6,7 +6,7 @@ description: "Start new one-on-one or group conversations by selecting users or import { EntryPoint } from "/snippets/entry-point.mdx"; - + ## Goal diff --git a/ui-kit/react/next-tab-based-chat.mdx b/ui-kit/react/next-tab-based-chat.mdx index 52691c099..023aaa5a0 100644 --- a/ui-kit/react/next-tab-based-chat.mdx +++ b/ui-kit/react/next-tab-based-chat.mdx @@ -6,8 +6,6 @@ description: "Build a tab-based chat interface with Chat, Call Logs, and Users t import { EntryPoint } from "/snippets/entry-point.mdx"; - - | Field | Value | @@ -22,6 +20,8 @@ import { EntryPoint } from "/snippets/entry-point.mdx"; + + This guide builds a tabbed messaging UI — Chat, Calls, and Users tabs in the sidebar, with a message view on the right. Good for full-featured apps that need more than just conversations. This assumes you've already completed [Next.js Integration](/ui-kit/react/integration-nextjs) (project created, UI Kit installed, init + login working). diff --git a/ui-kit/react/overview.mdx b/ui-kit/react/overview.mdx index 2600de3a9..867dca970 100644 --- a/ui-kit/react/overview.mdx +++ b/ui-kit/react/overview.mdx @@ -6,8 +6,6 @@ description: "Prebuilt React components for chat, voice, and video calling. Supp import { EntryPoint } from "/snippets/entry-point.mdx"; - - | Field | Value | @@ -22,6 +20,8 @@ import { EntryPoint } from "/snippets/entry-point.mdx"; + + 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. diff --git a/web-shared/localize.mdx b/web-shared/localize.mdx index 1fc8ddfef..694a579c9 100644 --- a/web-shared/localize.mdx +++ b/web-shared/localize.mdx @@ -5,7 +5,7 @@ description: "Localize — CometChat documentation." import { EntryPoint } from "/snippets/entry-point.mdx"; - + With language localization, CometChat UI Kit adapts to the language of a specific country or region. `CometChatLocalize` allows you to detect the language of your users based on their browser settings and set the language accordingly. diff --git a/web-shared/reactions-configuration.mdx b/web-shared/reactions-configuration.mdx index 1bffa3994..756c3b98c 100644 --- a/web-shared/reactions-configuration.mdx +++ b/web-shared/reactions-configuration.mdx @@ -5,7 +5,7 @@ description: "ReactionsConfiguration — CometChat documentation." import { EntryPoint } from "/snippets/entry-point.mdx"; - + You can modify the Reaction component's properties using the ReactionsConfiguration object. To use a configuration, you simply need to pass it to respective parameter. From 4a05ba4ba8c54c46f0e981b87e2a8c10660ffb83 Mon Sep 17 00:00:00 2001 From: amitthacker Date: Tue, 17 Nov 2026 21:51:16 +0530 Subject: [PATCH 4/4] Docs: address the review on the entry point snippet Four blocking link problems from the review, two already fixed on this branch and two not: - the JavaScript SDK page promised an integration guide and pointed at /sdk/javascript/overview, which is the Overview. Now /sdk/javascript/setup-sdk. - the iOS FCM notifications page is single stack but named no stack, so it fell back to the generic chooser. Now stack="iOS", and the guides map gains an iOS entry, which it had been missing entirely. Both targets exist on main and are in the navigation. Non-blocking items from the same review, where the fix is a matter of correctness rather than taste: - ui-kit/react/overview.mdx already carries a "Pick your framework" card group for React.js, Next.js, React Router and Astro. Hard-wiring React above it sent a Next.js or Astro reader to the Vite/CRA guide and past the picker. The line stays but drops its stack, so it points at the chooser. - web-shared/localize, web-shared/reactions-configuration and ui-kit/kotlin/2.0/ui-components are in no docs.json navigation group and have no redirects. They emitted utm_campaign=web-shared, naming a section that does not exist on the site. The entry point is removed from all three. Left alone deliberately: rest-api/banned-users/unban renders the line at the bottom because the OpenAPI body comes after the request and response examples. Dropping the page is a judgement the reviewer should make. Every remaining stack value resolves in the guides map; none falls back silently. Co-Authored-By: Claude Opus 5 --- notifications/ios-fcm-push-notifications.mdx | 2 +- snippets/entry-point.mdx | 3 ++- ui-kit/kotlin/2.0/ui-components.mdx | 1 - ui-kit/react/overview.mdx | 2 +- web-shared/localize.mdx | 1 - web-shared/reactions-configuration.mdx | 1 - 6 files changed, 4 insertions(+), 6 deletions(-) diff --git a/notifications/ios-fcm-push-notifications.mdx b/notifications/ios-fcm-push-notifications.mdx index c4bd365e4..fde7c2bcc 100644 --- a/notifications/ios-fcm-push-notifications.mdx +++ b/notifications/ios-fcm-push-notifications.mdx @@ -5,7 +5,7 @@ description: "Guide to integrating Firebase Cloud Messaging (FCM) push notificat import { EntryPoint } from "/snippets/entry-point.mdx"; - + FCM doesn't support VoIP pushes; use APNs + PushKit for VoIP calls. diff --git a/snippets/entry-point.mdx b/snippets/entry-point.mdx index dfe863dbd..22f480fec 100644 --- a/snippets/entry-point.mdx +++ b/snippets/entry-point.mdx @@ -33,7 +33,8 @@ export const EntryPoint = ({ stack, campaign }) => { "React Native": "/ui-kit/react-native/react-native-cli-integration", "Android": "/ui-kit/android/getting-started", "Android SDK": "/sdk/android/setup", - "JavaScript SDK": "/sdk/javascript/overview", + "iOS": "/ui-kit/ios/getting-started", + "JavaScript SDK": "/sdk/javascript/setup-sdk", }; const guide = stack ? guides[stack] : undefined; const [path, fragment] = (guide || "/chat-call").split("#"); diff --git a/ui-kit/kotlin/2.0/ui-components.mdx b/ui-kit/kotlin/2.0/ui-components.mdx index 7ddf5662c..279cba57f 100644 --- a/ui-kit/kotlin/2.0/ui-components.mdx +++ b/ui-kit/kotlin/2.0/ui-components.mdx @@ -5,7 +5,6 @@ description: "UI Components — CometChat documentation." import { EntryPoint } from "/snippets/entry-point.mdx"; - Version: v2 diff --git a/ui-kit/react/overview.mdx b/ui-kit/react/overview.mdx index 867dca970..c86983bf8 100644 --- a/ui-kit/react/overview.mdx +++ b/ui-kit/react/overview.mdx @@ -20,7 +20,7 @@ import { EntryPoint } from "/snippets/entry-point.mdx";
- + 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. diff --git a/web-shared/localize.mdx b/web-shared/localize.mdx index 694a579c9..dc8e5866d 100644 --- a/web-shared/localize.mdx +++ b/web-shared/localize.mdx @@ -5,7 +5,6 @@ description: "Localize — CometChat documentation." import { EntryPoint } from "/snippets/entry-point.mdx"; - With language localization, CometChat UI Kit adapts to the language of a specific country or region. `CometChatLocalize` allows you to detect the language of your users based on their browser settings and set the language accordingly. diff --git a/web-shared/reactions-configuration.mdx b/web-shared/reactions-configuration.mdx index 756c3b98c..94926b7df 100644 --- a/web-shared/reactions-configuration.mdx +++ b/web-shared/reactions-configuration.mdx @@ -5,7 +5,6 @@ description: "ReactionsConfiguration — CometChat documentation." import { EntryPoint } from "/snippets/entry-point.mdx"; - You can modify the Reaction component's properties using the ReactionsConfiguration object. To use a configuration, you simply need to pass it to respective parameter.