Currently we are working on publishing v3.0.0. Its in beta phase (v3.0.0-beta.2) at the moment. For v2.x.x (stable), please follow the docs here

The official React Native and Expo components for Stream Chat, a service for building chat applications.

Quick Links

• Stream Chat API product overview
• Register to get an API key for Stream Chat
• React Native Chat Tutorial
• Chat UI Kit
• Release Notes
• Internationalization (i18n)
• Cookbook 🚀

• React Native Compatibility
• React Native Chat Tutorial
• Example Apps
• Docs
• Keep in mind
• Setup
• TypeScript Support
• Internationalization
• Upgrade
• Common issues
• Contributing

To use this library you need to ensure you match up with the correct version of React Native you are using.

The best place to start is the React Native Chat Tutorial. It teaches you how to use this SDK and also shows how to make frequently required changes.

This repo includes 4 example apps. One made with Expo, one Native JavaScript code, and two in TypeScript. One TypeScript app is a simple implementation for reference, the other is a more full featured app example.

• Expo example
• Native example
• Typescript example
• Fully featured messaging application

Check out our tutorial on how to build a slack clone using react-native and stream-chat-react-native

• Tutorial https://dev.to/vishalnarkhede/how-to-build-slack-clone-with-react-native-part-2-g5

• Source code for app

  • react native https://github.com/GetStream/slack-clone-react-native/
  • expo https://github.com/GetStream/slack-clone-expo/

Please check following url for all the detailed documentation - https://github.com/GetStream/stream-chat-react-native/wiki#v30-beta

1. Navigation between different components is something we expect consumers to implement. You can check out the example given in this repository

2. Minor releases may come with some breaking changes, so always check the release notes before upgrading the minor version.

You can see detailed documentation about the components at https://getstream.github.io/stream-chat-react-native

Please follow this doc for setup - Setup Docs

As of version 2.0.0 stream-chat-react-native has been converted to TypeScript. Please read Typescript guide for details.

Please read Internationalization doc for details.

Please refer to Upgrade Helper

1. When you execute yarn ios for the first time, it starts a metro bundler in parallel. It can result in some errors since the build process isn't complete yet. Try the following to fix this:

   1. Close/stop the metro bundler process.
   2. Let the build process finish. It can usually take around 2-3 minutes for the first time.
   3. Start the metro bundler manually by executing yarn start inside stream-chat-react-native/examples/NativeMessaging directory.

2. When you execute yarn android, you may (not necessarily) run into following error:

   info Starting JS server...
   info Building and installing the app on the device (cd android && ./gradlew app:installDebug)...
   Starting a Gradle Daemon, 1 incompatible Daemon could not be reused, use --status for details
   
   FAILURE: Build failed with an exception.
   
   * What went wrong:
   A problem occurred configuring project ':@react-native-community_netinfo'.
   > SDK location not found. Define location with sdk.dir in the local.properties file or with an ANDROID_HOME environment variable.
   
   * Try:
   Run with --stacktrace option to get the stack trace. Run with --info or --debug option to get more log output. Run with --scan to get full insights.
   
   * Get more help at https://help.gradle.org
   
   BUILD FAILED in 13s
   error Could not install the app on the device, read the error above for details.
   Make sure you have an Android emulator running or a device connected and have
   set up your Android development environment:
   https://facebook.github.io/react-native/docs/getting-started.html
   error Command failed: ./gradlew app:installDebug. Run CLI with --verbose flag for more details.
   

   To resolve this, do the following.

   1. Create a file named local.properties inside stream-chat-react-native/examples/NativeMessaging/android directory

   2. Put the this line in that file. Make sure sdk path is correctly mentioned as per your system:

      sdk.dir=/Users/{user_name}/Library/Android/sdk/
      

   3. Rerun yarn android in stream-chat-react-native/examples/NativeMessaging directory

We welcome code changes that improve this library or fix a problem, and please make sure to follow all best practices and test all the changes. Please check our dev setup docs to get you started. We are pleased to merge your code into the official repository. Make sure to sign our Contributor License Agreement (CLA) first. See our license file for more details.