> ## Documentation Index
> Fetch the complete documentation index at: https://cometchat-22654f5b-docs-eng-38205-rn-gaps.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# React Native UI Kit v5 — LLM docs index

> Machine-readable, React-Native-v5-scoped index of every UI Kit page as a clean .md twin. Built for AI coding agents; kept out of the human sidebar.

# React Native UI Kit v5 — LLM docs index (Latest)

> Stateful, drop-in React Native chat/calling UI. Package
> `@cometchat/chat-uikit-react-native@5` + `@cometchat/chat-sdk-react-native@4`. This page is a
> **React-Native-v5-only** routing index for AI agents — a scoped alternative to the site-wide
> `/docs/llms.txt`.

## How to use this index

Each link points to the docs page; **append `.md`** to its URL to fetch the clean Markdown twin
(verbatim code + an "AI Integration Quick Reference" block with prop names, types, and defaults).
Pick the page for the intent, then read the props there.

* Convention: any docs page URL + `.md` → raw Markdown.
* Fallback: if a `.md` twin 404s, fetch the same URL **without** `.md` (HTML). Never read a
  package `.d.ts` and never answer props from memory.

## Platform rules — React Native is not the web

This kit renders **native views**, not DOM. Code that works in the React UI Kit does not port
1:1. Non-negotiables:

* **No CSS, no `className`, no `<div>`/`<a href>`, no `document.*`/`window.*`.** Styling is
  `StyleSheet` objects and the theme API — see [Theming](/ui-kit/react-native/theme).
* **Native peer deps are required**, not optional. Verified against
  `@cometchat/chat-uikit-react-native@5.4.0`: `@cometchat/chat-sdk-react-native`,
  `@react-native-clipboard/clipboard`, `@react-native-community/datetimepicker`,
  `react-native-gesture-handler`, `react-native-svg`, `react-native-video`,
  `react-native-localize`, `react-native-safe-area-context`,
  `@react-native-async-storage/async-storage`, `dayjs` (+ `punycode` on Expo). Install and
  pod-install them before first render; a missing native module fails at mount, not at build.
  Take the exact list from the integration page — do not infer it.
* **Android + async-storage v3 needs an extra Gradle line.** `@react-native-async-storage/async-storage`
  v3 ships a local Maven artifact; without the `local_repo` entry in `android/build.gradle` the
  Android build fails. See the integration page.
* **One screen per route.** Use a stack navigator and a real hardware/gesture back button —
  do not stack components on a single screen the way a web layout would.
* **Two toolchains, different setup:** React Native CLI (bare) and Expo. Pick the matching
  integration page below; the install/native-config steps differ.
* **No plugin API.** React v7's `CometChatMessagePlugin` and `CometChatPluginRegistry` **do not
  exist in this kit** — emitting them will not compile. RN customises through a **decorator
  chain**: extend `DataSourceDecorator`, override what you need calling `super` each time, and
  register with `ChatConfigurator.enable(...)` **after `CometChatUIKit.login()`** (login re-runs
  `ChatConfigurator.init()`, discarding anything registered earlier). See *Customization &
  extensibility* below.

## Hot path — usually no fetch needed

For a plain "add chat" the install, `init → login → render`, and the core drop-in props are
stable; a well-built agent skill bakes them. Fetch below only for exhaustive props, long-tail
components, theming tokens, or feature enablement.

* Setup (bare): [React Native CLI Integration](/ui-kit/react-native/react-native-cli-integration)
* Setup (Expo): [Expo Integration](/ui-kit/react-native/expo-integration)
* Core drop-ins: [Conversations](/ui-kit/react-native/conversations) · [Message Header](/ui-kit/react-native/message-header) · [Message List](/ui-kit/react-native/message-list) · [Message Composer](/ui-kit/react-native/message-composer)

## Getting started / integration

* [React Native CLI Integration](/ui-kit/react-native/react-native-cli-integration)
* [Expo Integration](/ui-kit/react-native/expo-integration)
* [React Native UI Kit — Overview](/ui-kit/react-native/overview)
* [Components Overview](/ui-kit/react-native/components-overview)
* [Apple Privacy Manifest](/ui-kit/react-native/apple-privacy-manifest-guide)

## Core & configuration

* [Core Features](/ui-kit/react-native/core-features)
* [Methods](/ui-kit/react-native/methods)
* [Events](/ui-kit/react-native/events)
* [Sound Manager](/ui-kit/react-native/sound-manager)
* [Localization](/ui-kit/react-native/localize)
* [Extensions](/ui-kit/react-native/extensions)
* [Troubleshooting](/ui-kit/react-native/troubleshooting)

## Theming & styling

* [Theming](/ui-kit/react-native/theme)
* [Color Resources](/ui-kit/react-native/colors)
* [Component Styling](/ui-kit/react-native/component-styling)
* [Message Bubble Styling](/ui-kit/react-native/message-bubble-styling)

## Components — conversations & lists

* [Conversations](/ui-kit/react-native/conversations)
* [Users](/ui-kit/react-native/users)
* [Groups](/ui-kit/react-native/groups)
* [Group Members](/ui-kit/react-native/group-members)

## Components — messages

* [Message Header](/ui-kit/react-native/message-header)
* [Message List](/ui-kit/react-native/message-list)
* [Message Composer](/ui-kit/react-native/message-composer)
* [Compact Message Composer](/ui-kit/react-native/compact-message-composer)
* [Threaded Messages Header](/ui-kit/react-native/threaded-messages-header)

## Components — calling

* [Call Buttons](/ui-kit/react-native/call-buttons)
* [Incoming Call](/ui-kit/react-native/incoming-call)
* [Outgoing Call](/ui-kit/react-native/outgoing-call)
* [Call Logs](/ui-kit/react-native/call-logs)
* [Calling Integration](/ui-kit/react-native/calling-integration)
* [Call Features](/ui-kit/react-native/call-features)

## Components — AI & notifications

* [Smart Chat Features](/ui-kit/react-native/ai-features)
* [AI Assistant Chat History](/ui-kit/react-native/ai-assistant-chat-history)
* [Notification Feed](/ui-kit/react-native/notification-feed)

## Customization & extensibility

The decorator chain — RN's equivalent of React's plugin system. Entries name the **API**, not just
the page, because the intent ("add a custom message type") does not match any page title.

* **Custom message type** — `DataSourceDecorator` · `ChatConfigurator.enable` ·
  `CometChatMessageTemplate` → [Message List → Filtering Messages](/ui-kit/react-native/message-list).
  Needs **four** overrides: `getAllMessageTemplates` · `getMessageTemplate` (render) **and**
  `getAllMessageTypes` · `getAllMessageCategories` (fetch — the list builds `setTypes`/`setCategories`
  from them). Shipping only the render pair gives a bubble that appears on send and **vanishes on
  reload, with no error**. Register after `login()`.
* **Long-press menu / composer actions** — `getMessageOptions` · `getAuxiliaryOptions` on the same
  decorator → [Message List](/ui-kit/react-native/message-list) · [Message Composer](/ui-kit/react-native/message-composer)
* **Custom bubble rendering** — view slots on each component → the component's own page
* **UI events** — `CometChatUIEvents` → [Events](/ui-kit/react-native/events)
* **Kit methods** — [Methods](/ui-kit/react-native/methods)

<Note>
  `DataSourceDecorator` / `MessageDataSource` / `ExtensionsDataSource` have **no dedicated RN page**
  yet — the custom-message-type contract is documented on Message List. Tracked as a docs gap.
</Note>

## Text formatters

* [Custom Text Formatter](/ui-kit/react-native/custom-text-formatter-guide)
* [Mentions Formatter](/ui-kit/react-native/mentions-formatter-guide)
* [ShortCut Formatter](/ui-kit/react-native/shortcut-formatter-guide)
* [URL Formatter](/ui-kit/react-native/url-formatter-guide)

## Task guides (recipes)

* [Guides — Overview](/ui-kit/react-native/guide-overview)
* [New Chat](/ui-kit/react-native/guide-new-chat)
* [Group Chat](/ui-kit/react-native/guide-group-chat)
* [Search Messages](/ui-kit/react-native/guide-search-messages)
* [Threaded Messages](/ui-kit/react-native/guide-threaded-messages)
* [Message Privately](/ui-kit/react-native/guide-message-privately)
* [Block / Unblock Users](/ui-kit/react-native/guide-block-unblock-user)
* [AI Agent Integration](/ui-kit/react-native/guide-ai-agent)

## Framework recipes (full-page layouts)

* React Native CLI: [Conversation + Messages](/ui-kit/react-native/react-native-conversation) · [One-to-One / Group](/ui-kit/react-native/react-native-one-to-one-chat) · [Tab-Based](/ui-kit/react-native/react-native-tab-based-chat)
* Expo: [Conversation + Messages](/ui-kit/react-native/expo-conversation) · [One-to-One / Group](/ui-kit/react-native/expo-one-to-one-chat) · [Tab-Based](/ui-kit/react-native/expo-tab-based-chat)

## Migration & misc

* [Upgrading from v4 to v5](/ui-kit/react-native/upgrading-from-v4)
* [v4 → v5 Property Changes](/ui-kit/react-native/property-changes)
* [Campaigns](/ui-kit/react-native/campaigns)
* [Changelog](/ui-kit/react-native/link/changelog)
* [Sample App](/ui-kit/react-native/link/sample)