NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev, #1159 most downloaded on pub.dev
The official Dart client for Stream Chat, a service for building chat applications.
Latest stable
10.7.0
Last release 7 days ago
10 Nov 2026
Ships fairly regularly
a new release about every 3 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
7 years old
256 releases · first in 2020
Drag across the ruler to compare, or tap a release to open it.
baseURL is now deprecated in favor of using Location to change data location.
🛑️ Breaking Changes from 1.5.3
ConnectUserWithProvider now requires tokenProvider as a required param. (Removed from the constructor)client.disconnect() is now divided into two different functions
client.closeConnection() -> for closing user websocket connection.client.disconnectUser() -> for disconnecting user and resetting client state.client.devToken() now returns a Token model instead of String.ApiError is removed in favor of StreamChatError
StreamChatError -> parent type for all the stream errors.StreamWebSocketError -> for user websocket related errors.StreamChatNetworkError -> for network related errors.client.queryChannels(), channel.query() options param is removed in favor of individual params
option.state -> bool stateoption.watch -> bool watchoption.presence -> bool presenceclient.queryUsers() options param is removed in favor of individual params
option.presence -> bool presence🐞 Fixed
✅ Added
Location enum is introduced for easily changing the client location/baseUrl.client.openConnection() and client.closeConnection() is introduced to connect/disconnect user ws connection.client.partialUpdateMessage and channel.partialUpdateMessage methodsconnectWebSocket parameter in connect user calls to use the client in "connection-less" mode.🔄 Changed
baseURL is now deprecated in favor of using Location to change data location.🛑️ Breaking Changes from 1.5.4
Migrate this package to null safety
Renamed ChannelImage to ChannelAvatar
Updated StreamChatThemeData.reactionIcons to accept custom builder
Renamed ColorTheme properties to reflect the purpose of the colors
ColorTheme.black -> ColorTheme.textHighEmphasisColorTheme.grey -> ColorTheme.textLowEmphasisColorTheme.greyGainsboro -> ColorTheme.disabledColorTheme.greyWhisper -> ColorTheme.bordersColorTheme.whiteSmoke -> ColorTheme.inputBgColorTheme.whiteSnow -> ColorTheme.appBgColorTheme.white -> ColorTheme.barsBgColorTheme.blueAlice -> ColorTheme.linkBgColorTheme.accentBlue -> ColorTheme.accentPrimaryColorTheme.accentRed -> ColorTheme.accentErrorColorTheme.accentGreen -> ColorTheme.accentInfoChannelListCore options property is removed in favor of individual properties
options.state -> bool stateoptions.watch -> bool watchoptions.presence -> bool presenceUserListView options property is removed in favor of individual properties
options.presence -> bool presenceRenamed ImageHeader to GalleryHeader
Renamed ImageFooter to GalleryFooter
MessageBuilder and ParentMessageBuilder signature is now
typedef MessageBuilder = Widget Function(
BuildContext,
MessageDetails,
List<Message>,
MessageWidget defaultMessageWidget,
);
the last parameter is the default MessageWidget
You can call .copyWith to customize just a subset of properties
✅ Added
MessageInputparentId to show typing indicator specific to threadsMessageWidget accepts a userAvatarBuilderMessageListView.threadSeparatorBuilder propertyMessageInput.onError property to allow error handlingGalleryHeader/GalleryFooter theme classes🐞 Fixed
Navigator to make using the SDK easier in a nested navigator use caseMessageListView not rendering if the user is not a member of the channelMessageInput overflow when there are no actions🛑️ Breaking Changes from 1.5.3
channelsBloc.queryChannels(), ChannelListCore options param/property is removed in favor of individual params/properties
options.state -> bool stateoptions.watch -> bool watchoptions.presence -> bool presenceusersBloc.queryUsers(), UserListCore options param/property is removed in favor of individual params/properties
options.presence -> bool presence✅ Added
connectivity_plus package🐞 Fixed
Your coding agent can read these notes before it upgrades. Set up the MCP server →
🛑️ Breaking Changes from 2.0.0-nullsafety.6
🛑️ Breaking Changes from 2.0.0-nullsafety.6
ConnectUserWithProvider now requires tokenProvider as a required param. (Removed from the constructor)client.disconnect() is now divided into two different functions
client.closeConnection() -> for closing user websocket connection.client.disconnectUser() -> for disconnecting user and resetting client state.client.devToken() now returns a Token model instead of String.ApiError is removed in favor of StreamChatError
StreamChatError -> parent type for all the stream errors.StreamWebSocketError -> for user websocket related errors.StreamChatNetworkError -> for network related errors.client.queryChannels(), channel.query() options param is removed in favor of individual params
option.state -> bool stateoption.watch -> bool watchoption.presence -> bool presenceclient.queryUsers() options param is removed in favor of individual params
option.presence -> bool presence✅ Added
Location enum is introduced for easily changing the client location/baseUrl.client.openConnection() and client.closeConnection() is introduced to connect/disconnect user ws connection.🔄 Changed
baseURL is now deprecated in favor of using Location to change data location.🐞 Fixed
🛑️ Breaking Changes from 2.0.0-nullsafety.7
channelsBloc.queryChannels(), ChannelListCore options param/property is removed in favor of individual
params/properties
options.state -> bool stateoptions.watch -> bool watchoptions.presence -> bool presenceusersBloc.queryUsers(), UserListCore options param/property is removed in favor of individual params/properties
options.presence -> bool presence🛑️ Breaking Changes from 2.0.0-nullsafety.7
ChannelListCore options property is removed in favor of individual properties
options.state -> bool stateoptions.watch -> bool watchoptions.presence -> bool presenceUserListView options property is removed in favor of individual properties
options.presence -> bool presenceMessageBuilder and ParentMessageBuilder signature is nowtypedef MessageBuilder = Widget Function(
BuildContext,
MessageDetails,
List<Message>,
MessageWidget defaultMessageWidget,
);
the last parameter is the default MessageWidget
You can call .copyWith to customize just a subset of properties
✅ Added
parentId to show typing indicator specific to threadsMessageWidget accepts a userAvatarBuilder🐞 Fixed
Navigator to make using the SDK easier in a nested navigator use caseMessageListView not rendering if the user is not a member of the channelFixed a bug with connectivity implementation
stream_chat_core dependency🛑️ Breaking Changes from 2.0.0-nullsafety.6
ConnectUserWithProvider now requires tokenProvider as a required parameter. (Removed from the
constructor)client.disconnect() is now divided into two different functions
client.closeConnection() -> for closing user web socket connection.client.disconnectUser() -> for disconnecting user and resetting client state.client.devToken() now returns a Token model instead of String.ApiError is removed in favor of StreamChatError
StreamChatError -> parent type for all the stream errors.StreamWebSocketError -> for user web socket related errors.StreamChatNetworkError -> for network related errors.client.queryChannels(), channel.query() options parameter is removed in favor of individual parameters
option.state -> bool stateoption.watch -> bool watchoption.presence -> bool presenceclient.queryUsers() options parameter is removed in favor of individual parameters
option.presence -> bool presence✅ Added
Location enum is introduced for easily changing the client location/baseUrl.client.openConnection() and client.closeConnection() is introduced to connect/disconnect
user WS connection.🔄 Changed
baseURL is now deprecated in favor of using Location to change data location.Fix thread reply not working with attachments
stream_chat_core dependencyFixed skip_push in client.sendMessage
skip_push in client.sendMessageconnectivity_plus packagestream_chat_core dependencyMessageListView.threadSeparatorBuilder propertyAdded new Filter.raw constructor
Filter.raw constructorMigrate this package to null safety
Migrate this package to null safety
stream_chat_core dependencyfix: StreamChatClient.connect returns quicker when you're using the persistence package
StreamChatClient.connect returns quicker when you're using the persistence packagestream_chat_core dependencyImproved test coverage to > 90%
queryChannels should throw exceptions only if no data is present in cache.Fixed unread count not updating while the chat is open
Fixed swipeable visible on navigation back
MessageInput: added more actions locations, merge actions and add showCommandsButton propertyAdded skip_push to message model
MessageListCore.messageFilter to filter messages locallyMessageInput only when sending commandsMessageSearchListViewStreamChatTheme adding more options and a new MessageInputTheme dedicated to MessageInputMessageWidget.customActionsMessageListView.onAttachmentTap callbackMessageListView scroll keyboard behaviour- Fixed queryChannels bug
Updated stream_chat_core dependency
stream_chat_core dependency- Debounced frequent db calls
Save pinned messages in offline storage
StreamClient.QueryChannels now returns a Stream and fetches the channels from storage before calling the apiStreamClient.QueryChannelsOnline and StreamClient.QueryChannelsOffline to fetch channels only from online or offlineMessageInputThemeMessageInput animationcustomAttachmentBuilders through MessageListViewstream_chat_core dependency🛑 BREAKING Changed signature of StreamClient.search method
StreamClient.search methodpinMessage feature docs hereAdd support for custom attachment upload docs here
Fixed issue with disconnecting after connecting without awaiting the connection result
Deprecated setUser, setGuestUser, setUserWithProvider in favor of connectUser , connectGuestUser , connectUserWithProvider
setUser, setGuestUser, setUserWithProvider in favor of connectUser
, connectGuestUser
, connectUserWithProvider- Fixed pub analysis issues
🛑 BREAKING Renamed Client to less generic StreamChatClient
Client to less generic StreamChatClientstream_chat_persistenceClient.backgroundKeepAlive
to core packageClient.showLocalNotification
to core package and renamed it
to StreamChatCore.onBackgroundEventReceivedflutter dependency. This is now a pure Dart package 🥳Nothing published for this version
Stop ws reconnection after calling disconnect
Fix reconnection bug while using tokenProvider
Nothing published for this version
Add merge helper functions in Message and ChannelModel for easier data manipulation
Message and ChannelModel for easier data manipulationThrow an error when calling queryChannels without an active connection
Do not throw an error when calling queryChannels without an active connection if the offline storage is enabled
Remove + notation from userAgent
Add thread_participants in message model
Add thread-less message reply feature (QuotedMessage)
Fix error in the offline storage queryChannelCids query
Fix but not throwing error during querychannels and persistance disabled
Fix channel.hide(clearHistory: true) not clearing local messages
Return offline data only if the backend is unreachable. This avoids the glitch of the ChannelListView because we cannot sort by custom properties.
Added message filters for Client.search()
Client.search()Correctly dispose resources when disposing the client state
clearUser parameter to client.disconnect to remove the user instance of the clientExpose messageInputDecoration as part of the theme
- Listen for user.updated events
Listen to reaction.updated event
- Fix reaction score updates
- Fix search message response
- Add event.extradata
Let user change channel.extradata if the channel is not initialized yet
Add parent_id to events for typing indicators in threads
Nothing published for this version
Fix error with reactions with null user
Do not save channels in memory if not being watched. This was leading to some bugs in some specific use-cases.
Add separatorBuilder to ChannelListView
separatorBuilder to ChannelListViewAdd default limit to pagination
- Fix bug with event filtering
Add separatorBuilder to ChannelListView
separatorBuilder to ChannelListViewAdding a message on Channel.update is now optional
Channel.update is now optional- Fix retry logic
Fix local sorting on offline storage
Client.channel returns an existing channel if available
Client.channel returns an existing channel if availableGetMessagesByIdResponse formatNothing published for this version
Experimental support for Flutter web and MacOs
One column per quarter.