Send your first message
Sendbird UIKit for React is a set of prebuilt UI components that allows you to easily craft an in-app chat with all the essential messaging features. Our development kit includes light and dark themes, fonts, colors and more. You can customize these components to create an interactive messaging interface unique to your brand identity.
Sendbird UIKit supports both open channels and group channels. Follow the guide below to start sending a message from scratch with
React. This library isn't designed to work with other frameworks such as
The dependencies for UIKit for React are:
React 16.8.0 or higher
React DOM 16.8.0 or higher
13 or higher
All modern versions
All modern versions
11 or higher
Before you start
Before installing Sendbird Chat SDK, you need to create a Sendbird application on the Sendbird Dashboard, which comprises everything required in a chat service including users, messages, and channels. You will need the
App ID of your Sendbird application when initializing the Chat SDK.
Note: Each Sendbird application can be integrated with a single client app. Within the same application, users can communicate with each other across all platforms, whether they are on mobile devices or on the web.
You can start building a modern messaging experience in your app by first installing Sendbird UIKit. This developer kit is an add-on feature to Sendbird Chat SDK so installing it will also install the core Chat SDK.
Step 1 Install UIKit
yarn, enter the following command.
If you're working in a TypeScript project, add the following line to
An example of a
tsconfig file should look like the following:
Next, import UIKit components to your app.
Step 2 Implement UIKit to your web app
Once you're done installing Sendbird UIKit, you can now implement it to your web app by using the
App component. The
App component is a group of essential UI components needed to build a functioning chat interface. You can also use our core components to your web app if you wish to make the interface more tailored to your needs.
Add the following pattern to use the
The chat interface can expand up to the dimensions of your parent component. To achieve a full-screen mode, apply the following CSS rules to the parent element.
Step 3 Send your first message
You can now run the app to send a message. First, create a group channel by clicking on the icon in the top-left corner. Then, you can select users you wish to invite as members to your channel. Once the channel has been created, enter your first message and send.
You've successfully sent your first message with Sendbird.
UIKit with SSR frameworks
You may refer to NextJS' sample for better understanding. You will need your own Sendbird application ID and user ID to use the sample.
App component is a collection of all UIKit components needed to quickly implement a basic chat, and only requires the app ID and user ID to be configured.
List of properties
The unique ID of the user.
An opaque string that identifies the user. It is recommended that every user has their own access token and provides it upon login for security. (Default:
A style applied to the app. Available themes are
The user's nickname. (Default:
The URL of the user's profile image. (Default:
The query factory class to retrieve a list of custom users. (Default: Chat SDK's
The set of strings for UIKit components. This can override the default language. (Default:
The set of colors used in the UIKit themes. This can overrides the default theme. (Default:
Determines whether to allow the user to edit their profile. (Default:
Determines whether to display the profile preview section when the avatar is selected. If set to
Determines whether to show the search icon in the channel title. (Default:
Specifies the prop to direct users to view either the parent message or the thread when they click on a reply button in the group channel module. Acceptable values are: