flutter_chat_core

This release introduces two-sided pagination. You can now load newer messages using the new onStartReached callback, while onEndReached continues to work for older messages. For pagination to work correctly, messages should be inserted instantly, without animation.

To allow this and offer more granular control, a new optional animated parameter has been added to all controller operations except update. This is not a breaking change, but if you'd like to use it, you can update your controller like so:

insertMessage(Message message, {int? index}) // ❌
insertMessage(Message message, {int? index, bool animated = true}) // ✅
ChatOperation.insert(..., animated: animated) // add animated to insert operations

insertAllMessages(List<Message> messages, {int? index}) // ❌
insertAllMessages(List<Message> messages, {int? index, bool animated = true}) // ✅
ChatOperation.insertAll(..., animated: animated) // add animated to insertAll operations

removeMessage(Message message) // ❌
removeMessage(Message message, {bool animated = true}) // ✅
ChatOperation.remove(..., animated: animated) // add animated to remove operations

setMessages(List<Message> messages) // ❌
setMessages(List<Message> messages, {bool animated = true}) // ✅
ChatOperation.set(..., animated: animated) // add animated to set operations

As an optional improvement, you can use this parameter to disable animations when clearing the chat, which is now the default behaviour in the example apps.

ChatOperation.set(messages, animated: messages.isEmpty ? false : animated) // inside the controller

⚠️ There is a small potential breaking change: LoadMoreNotifier was updated for two-sided loading. If you used a custom LoadMore widget and used LoadMoreNotifier to measure its height, that logic has been removed as it was not used. Additionally, the internal property _isLoading is now _isLoadingOlder, and _isLoadingNewer has been added.

• FEAT: implement two-sided pagination (#840). (8cca3141)

2.8.1

• FIX: composer inputClearMode and fix custom editing controller. (b4872190)

• FEAT: update deps - requires min dart 3.8 and flutter 3.32 (#871). (588b34bd)

• FEAT: allow for top widgets within the bubble (#814). (e267c27c)

• FEAT: implement two-sided pagination (#840). (8cca3141)

• FIX: update LICENSE. (209a1292)

• FEAT: link preview package (#790). (2938f646)

2.6.2

• FIX: new loadingBuilder for stream message. (38d539ac)

2.6.1

• FIX: add sendButtonDisabled and sendButtonHidden #828. (d476dd45)

• FEAT: link preview package (#790). (2938f646)

• FIX: update dependencies. (a8ff8b57)

• Use utf8 codec to parse chinese symbols

• Update dependencies. Requires Dart >= 2.15.1.

• FIX: add size attribute for ImageMessage (#813). (f50a3420)

• Update dependencies

⚠️ Breaking Changes ⚠️

onMessageTap and onMessageLongPress added BuildContext as a first parameter, so if you had something like this:

void _handleMessageLongPress(
  Message message, {
  int? index,
  LongPressStartDetails? details,
})

replace it with this:

void _handleMessageLongPress(
  BuildContext context,
  Message message, {
  int? index,
  LongPressStartDetails? details,
})

• FIX: scrollToIndex does not work when starting with an empty list #793. (1948c1f5)
• FEAT: add sendButtonVisibilityMode and allowEmptyMessage to the composer. (7a496607)
• FEAT: add method OnMessageDoubleTapCallback; add param BuildContext context for OnMessageTapCallback and OnMessageLongPressCallback (#817). (6fe68886)

2.5.3

• FIX: update dependencies. (a8ff8b57)

2.5.2

• Update a dependency to the latest release.

2.5.1

• FIX: re-enable composer blur. (791f7308)

• FIX: introduce status field back (#809). (1aadf874)
• FEAT: time and status grouping same minute fix #764 (#792). (61c04002)

• Updated dependencies (requires Dart >=2.14.0)

• Fixed Android example. Thanks @rvndsngwn for reporting!

• FIX: introduce status field back (#809). (1aadf874)
• FIX: prevent sending blank messages (#808). (6fbcfc73)
• FIX: perf improvements (#807). (71e6d690)
• FIX: allow to set a different color in Composer when not empty (#794). (788ca0c6)
• FEAT: time and status grouping same minute fix #764 (#792). (61c04002)

• FIX: add editedAt and pinned #797 (#798). (e164caa3)
• FEAT: expose isSentByMe and groupStatus in all messages builders (#805). (263d145b)

• Update to Flutter 2.5

• Rename REGEX_EMAIL to regexEmail and REGEX_LINK to regexLink

⚠️ Breaking Changes ⚠️

All message builders will also provide isSentByMe and groupStatus now. Just pass

{
  required bool isSentByMe,
  MessageGroupStatus? groupStatus,
}

after the index param. It is fine not to use these fields if not needed.

• FIX: add editedAt and pinned #797 (#798). (e164caa3)
• FEAT: expose isSentByMe and groupStatus in all messages builders (#805). (263d145b)

• FIX: expose user_cache and make it a changenotifier. (baa7eee6)
• FEAT: make messages required for set operation. (9e123732)

• Update dependencies

2.3.0

⚠️ Breaking Changes ⚠️

• Renamed LinkPreview → LinkPreviewData

• LinkPreview.imageUrl → LinkPreviewData.image.url

• Both LinkPreviewData.image.width and LinkPreviewData.image.height are now required

• FEAT: link preview v2 (#784). (b65060e1)

2.2.4

• FIX: add physics param to the ChatAnimatedList(Reversed). (ede3a170)
• FIX: emptyChatList not clickable (#787). (88937baa)

2.2.3

• FIX: add emptyChatListWidget (#771). (69954654)

2.2.2

• FIX: scroll to bottom button appearance threshold #769 (#774). (e97d5c13)

2.2.1

• FIX: list rebuilding when keyboard opens/closes. (48e28e7e)

• FEAT: link preview v2 (#784). (b65060e1)

• Improve REGEX

• Add custom imageBuilder

• FIX: add emptyChatListWidget (#771). (69954654)

• Update dependencies

• FIX: update operation not persisted in the list (#778). (37472015)
• FEAT: Fix StreamOperation Async issues / create insertAll / fixInsert on reverted list (#756). (60395f9b)

• Add hideImage param

• FIX: add audio message type. (8d2b705a)

• FIX: add video message type. (93a13840)

• FEAT: rename chat controller methods. (dc1bf57d)

• Update dependencies

• FIX: improve documentation and add example. (113141b3)

• Fix paddings for an empty preview data

• Limit number of images parsed

• Fix regex

• FIX: document public APIs.

• Fix custom padding and add a custom link press handler

• First stable release, keep the same version as flutter_chat_ui

• BREAKING : onPreviewDataFetched and previewData are now required. In the previous version, a link preview used on a ListView resulted in a fetch call every time the preview was appearing on a screen.

⚠️ Breaking changes ⚠️

• Updated the Message model to rename parentId to replyToMessageId
• The createdAt field is now optional in the message model
• The sending field has been removed from the message model; instead, you can set sending: true in the metadata of the Message model to achieve the same functionality.
• The isOnlyEmoji property has been removed from the text message model; to indicate that a message contains only emojis, use isOnlyEmoji: true in the metadata of the text message.
• The firstName and lastName fields in the User model have been consolidated into a single name field for improved simplicity.

Other changes

• Introduced MessageID and UserID typedefs to provide clearer context, while maintaining their underlying type as Strings
• Introduced TextStreamMessage type to support text streaming
• Added textStreamMessageBuilder to the Builders class to support text streaming UI widget

⚠️ Breaking changes ⚠️

• Rename inputBuilder to composerBuilder

⚠️ Breaking changes ⚠️

• Requires Freezed 3.0.0
• Replace status field with a computed getter that determines message state based on lifecycle timestamps (createdAt, deletedAt, sending, failedAt, sentAt, deliveredAt, seenAt, updatedAt). This enables granular message history tracking and status transitions, matching the behavior of popular chat applications.
• Rename overlay to hasOverlay in ImageMessage

Other changes

• Downgrade intl package version for better compatibility with other Flutter packages

• Added system message for displaying system notifications and events in chat

• Readme added

• Add UserCache class to store resolved users for synchronous access, preventing flickering in recycled widgets by caching user data with LRU eviction strategy
• Add ScrollToMessageMixin to enable programmatic scrolling in chat list:
  • scrollToMessage(messageId): Scrolls to a specific message by ID
  • scrollToIndex(index): Scrolls to a message at a specific index
  • Both methods support customizable animation duration, curve, alignment and offset
  • Can be used directly through any ChatController instance
  • See the pagination example in the example project for usage details
• Add validation to prevent duplicate message IDs

• Dependency update

• Require Flutter 3.29 and Dart 3.7

• Use types from utility library

⚠️ Breaking changes ⚠️

• Changed signature of chatMessageBuilder to include isRemoved and groupStatus parameters.
• Changed imageUrl to imageSource for the User model. Change is necessary to show that not only remote URLs are supported but also local assets.

• Make widget stateless

⚠️ Breaking changes ⚠️

🔄 Core Changes:

• author (type User) is replaced with authorId (type String) for simpler user management
• All DateTime properties now use milliseconds instead of microseconds for JSON serialization

🎨 Theme Simplification: Theme has been streamlined to 3 key parameters:

1. colors - Uses Material 3 semantic names (e.g. primary, onPrimary, secondary) making it easy to apply color schemes
2. typography - Follows Flutter's TextTheme semantic naming conventions
3. shape - Controls border radius of all messages (rounded vs square messages)

✨ Enhanced Customization:

• Individual widget customization available through the builders parameter
• Example: loadMoreBuilder: (context) => LoadMore(color: Colors.red) overrides theme colors
• Full widget customization possible by returning custom widgets from builders

• Render plain text on loading and error

• Added isOnlyEmoji parameter to TextMessage.
• Message builders now include the message index in their parameters.
• Reverted withValues to withOpacity to resolve a compatibility issue.

• Critical fix and remove unneeded code

• Added customMessageBuilder for building custom messages
• Added overlay parameter to ImageMessage
• Themes:
  • Added ImageMessageTheme (replacing imagePlaceholderColor)
  • Updated InputTheme (adding textFieldColor)
  • Updated ScrollToBottomTheme
  • Updated TextMessageTheme
• Added UploadProgressMixin for handling upload progress tracking

• Code improvements and cleanup

• Bump version to support flutter_chat_ui v2 alpha release

• Added customization

• Initial release

• Initial release

365

likes

150

points

67.7k

downloads

Documentation

API reference

Publisher

flyer.chat

Weekly Downloads

Metadata

Customizable link and URL preview extracted from the provided text with the ability to render from the cache. Ideal for chat applications.

Homepage

Repository (GitHub)

View/report issues

Contributing

License

MIT ( license )

Dependencies

flutter , flutter_chat_core , html , http , punycode , url_launcher

More

Packages that depend on flutter_link_previewer

← Metadata

365

likes

150

points

67.7k

downloads

Documentation

API reference

Publisher

flyer.chat

Weekly Downloads

Metadata

Customizable link and URL preview extracted from the provided text with the ability to render from the cache. Ideal for chat applications.

Homepage

Repository (GitHub)

View/report issues

Contributing

License

MIT ( license )

Dependencies

flutter , flutter_chat_core , html , http , punycode , url_launcher

More

Packages that depend on flutter_link_previewer

Back