cometchat · Farhan-CometChat · Feb 16, 2026 · Feb 17, 2026 · Feb 17, 2026 · Feb 17, 2026
diff --git a/.gitignore b/.gitignore
@@ -13,3 +13,4 @@ __pycache__/
 /docs-templates
 /docs-test-suite
 /prompts
+/docs-comparison-tool
diff --git a/docs.json b/docs.json
@@ -2932,7 +2932,14 @@
                             "pages": [
                               "sdk/react-native/resources-overview",
                               "sdk/react-native/real-time-listeners",
-                              "sdk/react-native/push-notification-setup",
+                              {
+                                "group": "Push Notifications",
+                                "pages": [
+                                  "notifications/react-native-push-notifications-android",
+                                  "notifications/react-native-push-notifications-ios"
+                                ]
+                              },
+                              "sdk/react-native/push-notification-html-stripping",
                               "sdk/react-native/upgrading-from-v3"
                             ]
                           },
@@ -5904,8 +5911,8 @@
       "destination": "/notifications/sms-notifications-extension-legacy"
     },
     {
-        "source": "/notifications/react-native-push-notifications",
-        "destination": "/notifications/react-native-push-notifications-android" 
+      "source": "/notifications/react-native-push-notifications",
+      "destination": "/notifications/react-native-push-notifications-android" 
     },
     {
       "source": "/sdk/ionic/overview",

diff --git a/images/overview_cometchat_screens.png b/images/overview_cometchat_screens.png
diff --git a/images/shortcut_formatter_cometchat_screens.png b/images/shortcut_formatter_cometchat_screens.png
diff --git a/images/xcode-embedd-extensions-debug.png b/images/xcode-embedd-extensions-debug.png
diff --git a/images/xcode-notificaion-service-maintarget-screenshot.png b/images/xcode-notificaion-service-maintarget-screenshot.png
diff --git a/images/xcode-notificaion-service-screenshot.png b/images/xcode-notificaion-service-screenshot.png
diff --git a/images/xcode-objectiveC.png b/images/xcode-objectiveC.png
@@ -1,8 +1,18 @@
 ---
 title: "Advanced"
 sidebarTitle: "Overview"
+description: "Advanced CometChat React Native SDK topics including connection status monitoring and manual WebSocket management."
 ---
 
+This section helps you to know about the Connection Listeners.
 
+## Next Steps
 
-This section helps you to know about the Connection Listeners.
+<CardGroup cols={2}>
+<Card title="Connection Status" icon="signal" href="/sdk/react-native/connection-status">
+Monitor real-time WebSocket connection status
+</Card>
+<Card title="Managing WebSockets Manually" icon="plug" href="/sdk/react-native/managing-web-sockets-connections-manually">
+Take control of WebSocket connections
+</Card>
+</CardGroup>
@@ -1,17 +1,36 @@
 ---
 title: "AI Agents"
+description: "Learn how to integrate AI Agents in your React Native app using the CometChat SDK, including real-time event streaming and agentic message handling."
 ---
 
-# AI Agents Overview
+<Info>
+**Quick Reference**
+```javascript
+// Listen for real-time AI Agent events
+CometChat.addAIAssistantListener("listenerId", {
+  onAIAssistantEventReceived: (event) => {}
+});
+
+// Listen for persisted agentic messages
+CometChat.addMessageListener("listenerId", {
+  onAIAssistantMessageReceived: (message) => {},
+  onAIToolResultReceived: (message) => {},
+  onAIToolArgumentsReceived: (message) => {}
+});
+```
+</Info>
+
+## Overview
 
 AI Agents enable intelligent, automated interactions within your application. They can process user messages, trigger tools, and respond with contextually relevant information. For a broader introduction, see the [AI Agents section](/ai-agents).
 
-> **Note:**
-> Currently, an Agent only responds to **Text Messages**.
+<Note>
+Currently, an Agent only responds to **Text Messages**.
+</Note>
 
 ## Agent Run Lifecycle and Message Flow
 
-This section explains how a user’s text message to an Agent becomes a structured "run" which emits real-time events and then produces agentic messages for historical retrieval.
+This section explains how a user's text message to an Agent becomes a structured "run" which emits real-time events and then produces agentic messages for historical retrieval.
 - A user sends a text message to an Agent.
 - The platform starts a run and streams real-time events via the **`AIAssistantListener`**.
 - After the run completes, persisted Agentic Messages arrive via the **`MessageListener`**.
@@ -34,7 +53,7 @@ Events are received via the **`onAIAssistantEventReceived`** method of the **`AI
 Notes:
 - `Run Start` and `Run Finished` are always emitted.
 - `Tool Call` events appear only when a backend or frontend tool is invoked. There can be multiple tool calls in a single run.
-- `Text Message` events are always emitted and carry the assistant’s reply incrementally.
+- `Text Message` events are always emitted and carry the assistant's reply incrementally.
 
 <Tabs>
     <Tab title="JavaScript">
@@ -69,16 +88,26 @@ Notes:
     </Tab>
 </Tabs>
 
-#### Event descriptions
-- Run Start: A new run has begun for the user’s message.
-- Tool Call Start: The agent decided to invoke a tool.
-- Tool Call Arguments: Arguments being passed to the tool.
-- Tool Call End: Tool execution completed.
-- Tool Call Result: Tool’s output is available.
-- Text Message Start: The agent started composing a reply.
-- Text Message Content: Streaming content chunks for progressive rendering.
-- Text Message End: The agent reply is complete.
-- Run Finished: The run is finalized; persisted messages will follow.
+<Warning>
+Always remove AI Assistant listeners when the component unmounts to prevent memory leaks.
+```javascript
+CometChat.removeAIAssistantListener("unique_listener_id");
+```
+</Warning>
+
+#### Event Descriptions
+
+| Event | Description |
+|-------|-------------|
+| Run Start | A new run has begun for the user's message |
+| Tool Call Start | The agent decided to invoke a tool |
+| Tool Call Arguments | Arguments being passed to the tool |
+| Tool Call End | Tool execution completed |
+| Tool Call Result | Tool's output is available |
+| Text Message Start | The agent started composing a reply |
+| Text Message Content | Streaming content chunks for progressive rendering |
+| Text Message End | The agent reply is complete |
+| Run Finished | The run is finalized; persisted messages will follow |
 
 ### Agentic Messages
 
@@ -131,4 +160,39 @@ These events are received via the **`MessageListener`** after the run completes.
         CometChat.removeMessageListener(listnerId);
         ```
     </Tab>
-</Tabs>
+</Tabs>
+
+<Warning>
+Always remove message listeners when the component unmounts to prevent memory leaks.
+```javascript
+CometChat.removeMessageListener("unique_listener_id");
+```
+</Warning>
+
+<AccordionGroup>
+<Accordion title="Best Practices">
+- Register both `AIAssistantListener` (for real-time streaming) and `MessageListener` (for persisted messages) to get the complete agent interaction flow
+- Use `Text Message Content` events for progressive rendering of the agent's reply as it streams in
+- Handle `Tool Call` events to show tool execution status in your UI (e.g., loading indicators)
+- Always remove both listeners on component unmount to avoid memory leaks
+- Since agents only respond to text messages, validate the message type before sending to an agent
+</Accordion>
+
+<Accordion title="Troubleshooting">
+- **No events received**: Ensure you registered the `AIAssistantListener` with a unique listener ID before sending a message to the agent.
+- **Missing agentic messages**: Agentic messages arrive via `MessageListener` after the run completes. Make sure you have both listeners registered.
+- **Duplicate events**: Verify you are not registering the same listener ID multiple times without removing the previous one.
+- **Tool call events not appearing**: Tool call events only fire when the agent invokes a tool. Not all runs include tool calls.
+</Accordion>
+</AccordionGroup>
+
+## Next Steps
+
+<CardGroup cols={2}>
+<Card title="AI Agents Overview" icon="robot" href="/ai-agents">
+Explore the full AI Agents platform documentation
+</Card>
+<Card title="AI Moderation" icon="shield-check" href="/sdk/react-native/ai-moderation">
+Automatically moderate messages using AI
+</Card>
+</CardGroup>
@@ -1,7 +1,26 @@
 ---
 title: "AI Moderation"
+description: "Learn how to use AI-powered message moderation in your React Native app using the CometChat SDK, including real-time moderation events and handling disapproved messages."
 ---
 
+<Info>
+**Quick Reference**
+```javascript
+// Send a message and check moderation status
+CometChat.sendMessage(textMessage).then((message) => {
+  const status = message.getModerationStatus();
+  // CometChat.ModerationStatus.PENDING | APPROVED | DISAPPROVED
+});
+
+// Listen for moderation results
+CometChat.addMessageListener("listenerId", new CometChat.MessageListener({
+  onMessageModerated: (message) => {
+    const status = message.getModerationStatus();
+  }
+}));
+```
+</Info>
+
 ## Overview
 
 AI Moderation in the CometChat SDK helps ensure that your chat application remains safe and compliant by automatically reviewing messages for inappropriate content. This feature leverages AI to moderate messages in real-time, reducing manual intervention and improving user experience.
@@ -16,7 +35,7 @@ Before using AI Moderation, ensure the following:
 
 1. Moderation is enabled for your app in the [CometChat Dashboard](https://app.cometchat.com)
 2. Moderation rules are configured under **Moderation > Rules**
-3. You're using CometChat SDK version that supports moderation
+3. You're using a CometChat SDK version that supports moderation
 
 ## How It Works
 
@@ -202,6 +221,13 @@ Register a message listener to receive moderation results in real-time:
   </Tab>
 </Tabs>
 
+<Warning>
+Always remove message listeners when the component unmounts to prevent memory leaks.
+```javascript
+CometChat.removeMessageListener("MODERATION_LISTENER");
+```
+</Warning>
+
 ### Step 3: Handle Disapproved Messages
 
 When a message is disapproved, handle it appropriately in your UI:
@@ -223,5 +249,30 @@ function handleDisapprovedMessage(message) {
 }
 ```
 
+<AccordionGroup>
+<Accordion title="Best Practices">
+- Always check `getModerationStatus()` after sending a message to show appropriate UI indicators (e.g., a pending badge)
+- Register the `onMessageModerated` listener early in your app lifecycle so you don't miss moderation results
+- Provide clear feedback to users when their message is disapproved — avoid silently hiding content without explanation
+- Custom and Action messages are not moderated — if you need moderation on custom message types, implement your own server-side checks
+- Consider caching moderation status locally to avoid re-checking on message list re-renders
+</Accordion>
+
+<Accordion title="Troubleshooting">
+- **Moderation status always PENDING**: Ensure moderation rules are configured in the CometChat Dashboard under **Moderation > Rules**.
+- **`onMessageModerated` not firing**: Verify you registered a `MessageListener` with the correct listener ID and that moderation is enabled for your app.
+- **Custom messages not being moderated**: This is expected — AI Moderation only applies to text, image, and video messages.
+- **Disapproved messages still visible**: Make sure your `onMessageModerated` handler updates the UI when a message status changes to `DISAPPROVED`.
+</Accordion>
+</AccordionGroup>
+
 ## Next Steps
-After implementing AI Moderation, consider adding a reporting feature to allow users to flag messages they find inappropriate. For more details, see the [Flag Message](/sdk/react-native/flag-message) documentation.
+
+<CardGroup cols={2}>
+<Card title="Flag Message" icon="flag" href="/sdk/react-native/flag-message">
+Allow users to report inappropriate messages
+</Card>
+<Card title="AI Agents" icon="robot" href="/sdk/react-native/ai-agents">
+Add intelligent AI agent interactions
+</Card>
+</CardGroup>