Skip to main content
This document outlines the property changes between V5 and V6 of the CometChat Flutter UI Kit. V6 introduces BLoC-based state management, removes composite widgets, and consolidates styling into ThemeData extensions.

Architectural Changes

AspectV5V6
State ManagementGetXBLoC
Composite WidgetsCometChatMessages, CometChatConversationsWithMessages, etc.Removed — compose individually
Data SourceCometChatUIKit.getDataSource()MessageTemplateUtils
Extension RegistrationUIKitSettings.extensionsHandled internally
Rich TextNot availableBuilt-in rich text formatting
Code BlocksNot availableBuilt-in code block support

Conversations

New Properties (V6)

NameTypeDescription
conversationsBlocConversationsBloc?Provide a custom BLoC instance
routeObserverRouteObserver?Freeze rebuilds during navigation
hideSearchbool?Hide the search bar
searchReadOnlybool?Make search bar read-only
onSearchTapVoidCallback?Callback when search is tapped

Removed Properties (from V5)

NameDescription
themeReplaced by ThemeData extensions
errorStateText, emptyStateText, loadingStateTextUse custom state views instead
stateCallBackUse BLoC events instead
avatarStyle, statusIndicatorStyle, badgeStyle, receiptStyle, dateStyleConsolidated into CometChatConversationsStyle
hideSeparatorControlled via style
disableTypingHandled internally
deleteConversationDialogStyleIntegrated into main style
disableMentionsHandled via text formatters

Message List

New Properties (V6)

NameTypeDescription
messageListBlocMessageListBloc?Provide a custom BLoC instance
enableConversationStartersboolEnable AI conversation starters
enableSmartRepliesboolEnable AI smart replies
addTemplateList<CometChatMessageTemplate>?Add custom templates to existing ones
hideModerationViewboolHide moderation view

Removed Properties (from V5)

NameDescription
themeReplaced by ThemeData extensions
scrollToBottomOnNewMessagesHandled internally
timestampAlignmentControlled via style
messageInformationConfigurationHandled via BLoC
reactionListConfiguration, reactionsConfigurationSimplified

Message Composer

New Properties (V6)

NameTypeDescription
messageComposerBlocMessageComposerBloc?Provide a custom BLoC instance
hideSendButtonbool?Hide send button
hideAttachmentButtonbool?Hide attachment button
hideStickersButtonbool?Hide sticker button
hideImageAttachmentOptionbool?Hide image attachment
hideVideoAttachmentOptionbool?Hide video attachment
hideAudioAttachmentOptionbool?Hide audio attachment
hideFileAttachmentOptionbool?Hide file attachment
hidePollsOptionbool?Hide polls option
hideCollaborativeDocumentOptionbool?Hide collaborative document
hideCollaborativeWhiteboardOptionbool?Hide collaborative whiteboard
hideTakePhotoOptionbool?Hide take photo option

Removed Properties (from V5)

NameDescription
themeReplaced by ThemeData extensions
hideLiveReaction, liveReactionIcon, liveReactionIconURLFeature removed
mediaRecorderStyleIntegrated into main style

Message Header

New Properties (V6)

NameTypeDescription
titleViewWidget? Function(Group?, User?, BuildContext)?Custom title widget
leadingStateViewWidget? Function(Group?, User?, BuildContext)?Custom leading widget
auxiliaryButtonViewWidget? Function(Group?, User?, BuildContext)?Custom auxiliary button
hideVideoCallButtonbool?Hide video call button
hideVoiceCallButtonbool?Hide voice call button

Removed Properties (from V5)

NameDescription
themeReplaced by ThemeData extensions
avatarStyle, statusIndicatorStyleConsolidated into CometChatMessageHeaderStyle
privateGroupIcon, protectedGroupIconHandled via style
disableTypingHandled internally

Users

New Properties (V6)

NameTypeDescription
usersBlocUsersBloc?Provide a custom BLoC instance
setOptionsFunction?Set long press actions
addOptionsFunction?Add to long press actions
trailingViewWidget? Function(BuildContext, User)?Custom trailing widget
leadingViewWidget? Function(BuildContext, User)?Custom leading widget
titleViewWidget? Function(BuildContext, User)?Custom title widget

Removed Properties (from V5)

NameDescription
themeReplaced by ThemeData extensions
listItemStyle, avatarStyle, statusIndicatorStyleConsolidated into CometChatUsersStyle
optionsReplaced by setOptions/addOptions

Groups

New Properties (V6)

NameTypeDescription
groupsBlocGroupsBloc?Provide a custom BLoC instance
groupTypeVisibilityboolHide group type icon
setOptionsFunction?Set long press actions
addOptionsFunction?Add to long press actions
trailingViewWidget? Function(BuildContext, Group)?Custom trailing widget
leadingViewWidget? Function(BuildContext, Group)?Custom leading widget
titleViewWidget? Function(BuildContext, Group)?Custom title widget

Removed Properties (from V5)

NameDescription
themeReplaced by ThemeData extensions
listItemStyle, avatarStyle, statusIndicatorStyleConsolidated into CometChatGroupsStyle
optionsReplaced by setOptions/addOptions

Group Members

New Properties (V6)

NameTypeDescription
hideKickMemberOptionbool?Control kick member visibility
hideBanMemberOptionbool?Control ban member visibility
hideScopeChangeOptionbool?Control scope change visibility
usersStatusVisibilityboolControl status indicator visibility

Renamed Properties

V5 NameV6 NameDescription
tailViewtrailingViewCustom trailing widget
disableUsersPresenceusersStatusVisibilityInverted logic
groupMemberStylestyleType changed to CometChatGroupMembersStyle