Table of Contents
This is the official Android SDK for Stream Chat, a assistance for constructing chat and messaging programs. This library contains each a lower-stage chat SDK and a set of reusable UI elements. Most users begin with the UI components, and slide again to the decrease level API when they want to personalize issues.
The SDK supports equally Kotlin and Java, but we strongly propose working with Kotlin.
🔗 Rapid Links
👩💻 Cost-free for Makers 👨💻
Stream is totally free for most facet and interest initiatives. To qualify, your challenge/corporation desires to have < 5 team members and < $10k in monthly revenue. For complete pricing details, visit our Chat Pricing Page.
🗺️ Overview and Documentation 📚
This SDK consists of three main artifacts you can build on:
- Client: A low-level client for making API calls and receiving chat events.
- Offline support: Local caching and automatic retries, exposed via Flow and LiveData APIs.
- UI Components: Reusable and customizable chat Views for displaying conversations, lists of channels, and more!
We also support Jetpack Compose! You can use our Compose UI Components as an alternative to the UI Components.
- Compose UI Components: Reusable and modular Composables for displaying conversations, lists of channels, and more!
Learn more about the modules by visiting the documentation.
📖 Tutorial
The best place to start is the Android In-App Messaging Tutorial. It teaches you the basics of using this SDK and also shows how to make frequently required changes.
🛠️ Installation and Getting Started 🚀
See the Dependencies and Getting Started pages of the documentation.
📲 Sample App
This repo includes a fully functional example app featuring threads, reactions, typing indicators, optimistic UI updates and offline storage. To run the sample app, start by cloning this repo:
git clone [email protected]:GetStream/stream-chat-android.git
Next, open Android Studio and open the newly created project folder. You’ll want to run the stream-chat-android-ui-components-sample app.
🏗️ Jetpack Compose Sample App
We also have a UI implementation built in Jetpack Compose available, currently in a beta version.
This also comes with its own example app, which you can try by cloning this repo, and then running the app in the stream-chat-android-compose-sample module.
As this is a beta, we’re eager to hear your feedback. Join us in this repo’s discussions or tweet at us @getstream_io!
💡 Supported features 🎨
Here are some of the features that the SDK supports out-of-the-box:
- Channels list UI
- Channel UI
- Message reactions
- Link previews
- Image, video and file attachments
- Editing and deleting messages
- Typing indicators
- Read indicators
- Push notifications
- Image gallery
- GIF support
- Light and dark themes
- Style customization
- UI customization
- Threads
- Slash commands
- Markdown message formatting
- Unread message counts
For more, see the SDK’s website.
💼 We are hiring!
We’ve recently closed a $38 million Series B funding round and we keep actively growing. Our APIs are used by more than a billion end-users, and you’ll have a chance to make a huge impact on the product within a team of the strongest engineers all over the world. Check out our current openings and apply via Stream’s website.
