Skip to main content
{
  "package": "@cometchat/chat-uikit-react",
  "requiredSetup": "CometChatUIKit.init(UIKitSettings) then CometChatUIKit.login(UID)",
  "coreFeatures": [
    "Instant Messaging",
    "Media Sharing",
    "Read Receipts",
    "Typing Indicator",
    "User Presence",
    "Reactions",
    "Mentions",
    "Threaded Conversations",
    "Search",
    "Moderation"
  ],
  "keyComponents": [
    "CometChatConversations",
    "CometChatMessageList",
    "CometChatMessageComposer",
    "CometChatMessageHeader",
    "CometChatUsers",
    "CometChatGroups"
  ]
}

Overview

The CometChat React UI Kit provides a comprehensive set of chat features out of the box. This guide maps each core feature to the components that power it, helping you understand how to build a complete chat experience. Time estimate: 5 minutes
Difficulty: Beginner

Prerequisites

Core Features

Instant Messaging

Real-time text messaging is the foundation of any chat application.
ComponentRole
Message ComposerWrite and send messages
Message ListDisplay sent and received messages
Instant messaging

Media Sharing

Share images, videos, audio files, and documents within conversations.
ComponentRole
Message ComposerAttach and send media files
Message ListRender media message bubbles
Media sharing

Read Receipts

Show message delivery and read status to users.
ComponentRole
ConversationsDisplay last message status
Message ListShow receipt indicators on messages
Read receipts

Typing Indicator

Show when users are typing in real-time.
ComponentRole
ConversationsShow typing status in list
Message HeaderDisplay “typing…” indicator
Typing indicator

User Presence

Display online/offline status for contacts.
ComponentRole
ConversationsShow presence in conversation list
Message HeaderDisplay user status
UsersShow presence in user list
Group MembersShow member presence
User presence

Reactions

Allow users to react to messages with emojis.
ComponentRole
Message ListDisplay and manage reactions
Reactions

Mentions

Tag users directly in messages with @mentions.
ComponentRole
ConversationsShow mention indicators
Message ComposerEnable @mention input
Message ListRender mention formatting
Mentions

Threaded Conversations

Reply directly to specific messages to keep conversations organized.
ComponentRole
Threaded MessagesDisplay parent message with replies
Threaded conversations
Find conversations, messages, and media across chats.
ComponentRole
SearchSearch across conversations
Message HeaderIn-conversation search
Message ListHighlight search results
Search

Group Chat

Enable multi-participant conversations.
ComponentRole
GroupsList and manage groups
Group MembersManage group participants
Group chat

Quick Start

Get all core features with a single component:
import { CometChatConversationsWithMessages } from "@cometchat/chat-uikit-react";
import "@cometchat/chat-uikit-react/css-variables.css";

function Chat() {
  return (
    <div style={{ height: "100vh" }}>
      <CometChatConversationsWithMessages />
    </div>
  );
}
This composite component includes:
  • Conversation list with presence and typing indicators
  • Message list with reactions, receipts, and media support
  • Message composer with mentions and attachments
  • Message header with user/group info

Next Steps