chat_bubbles 1.9.0

Flutter chat bubble widgets, similar to Whatsapp and more shapes. Easy to use and implement chat bubbles.

1.9.0 02/03/2026

New Features

Message Status Enhancements

• Added timestamp parameter to all bubble widgets for displaying message send time
• Added isEdited flag that shows an italic "Edited" label next to the status area
• Added isForwarded flag that shows a "Forwarded" banner at the top of the bubble
• Added messageId parameter for programmatic message tracking
• New internal BubbleStatusRow helper widget for consistent status row rendering
• New internal BubbleForwardedHeader helper widget for the forwarded banner

SwipeableBubble Widget

• Added SwipeableBubble wrapper widget for swipe gesture support on any bubble
• Swipe-right gesture (configurable icon + color) for reply actions
• Swipe-left gesture (configurable icon + color) for delete actions
• Configurable swipeThreshold (default: 64 logical pixels)
• Smooth spring-back animation when threshold is not met
• Optional haptic feedback via enableHaptics
• Circular action icon revealed behind the bubble during swipe

Message Groups / Clustering

• Added BubbleGroupBuilder widget for automatic consecutive-sender grouping
• Added MessageGroupHelper.compute() utility for deriving grouping info from a flat list
• Added GroupInfo data class with showTail, showAvatar, isGroupStart, isGroupEnd, isAlone
• Configurable groupingThreshold (default: 1 minute) to split groups on time gaps
• Configurable itemSpacing and groupSpacing for fine-grained vertical rhythm

Voice Message Waveform

• BubbleNormalAudio now accepts waveformData (List<double>) for bar-chart waveform visualization
• Interactive waveform scrubbing via tap or horizontal drag
• waveformActiveColor and waveformInactiveColor for played/unplayed portions
• Playback speed toggle button (1x / 1.5x / 2x) via showPlaybackSpeed, playbackSpeed, and onPlaybackSpeedChanged
• Falls back gracefully to the existing Slider when waveformData is null

Improvements

• Updated example app with demo sections for all v1.9.0 features
• Updated README.md with v1.9.0 usage examples and parameter tables
• Updated exports in chat_bubbles.dart for SwipeableBubble, BubbleGroupBuilder, MessageGroupHelper, and GroupInfo

1.8.0 17/01/2026

New Features

BubbleReply Widget

• Added BubbleReply widget for displaying quoted/replied messages
• WhatsApp-style reply bubbles with original message preview
• Customizable reply indicator line color and background
• Support for sender name and message preview
• Tap callbacks for reply section interaction

TypingIndicator Widgets

• Added TypingIndicator widget with animated dots
• Added TypingIndicatorWave widget with wave animation style
• Customizable animation duration and colors
• Toggle visibility with showIndicator parameter
• Smooth animations optimized for performance

BubbleLinkPreview Widget

• Added BubbleLinkPreview widget for URL previews
• Display link metadata (title, description, image)
• Optional preview image with error handling
• Customizable preview card styling
• Support for messages with or without accompanying text

Reaction System

• Added BubbleReaction widget for emoji reactions
• Added Reaction data model for reaction state
• Added ReactionPicker widget for selecting reactions
• Added ReactionOverlay widget for long-press reaction selection
• Support for multiple reactions per message
• User reaction highlighting
• Customizable reaction chip styling

Improvements

• Updated example app to showcase all new v1.8.0 features
• Added comprehensive documentation for new widgets
• Improved widget organization with new directories (indicators/, reactions/)

1.7.1 17/01/2026

Breaking Changes

• BREAKING: Renamed public constants to follow lowerCamelCase naming convention:

  • BUBBLE_RADIUS → defaultBubbleRadius
  • BUBBLE_RADIUS_IMAGE → defaultBubbleRadiusImage
  • BUBBLE_RADIUS_AUDIO → defaultBubbleRadiusAudio

  If you were using these constants directly in your code, you'll need to update the references.

Code Quality Improvements

• Added comprehensive documentation comments for all public members
• Removed unnecessary Container widgets in MessageBar
• Added analysis_options.yaml with public_member_api_docs lint rule
• Fixed all auto-fixable lint issues (removed unnecessary new, this., etc.)
• Improved code formatting and style consistency

1.7.0 05/01/2025

• support up-to-date dependencies
• update the example
• update the documentation

1.6.0 20/01/2024

For Message Bar

• Customizable text style for message bar text

For BubbleNormal Widget

• Added optional [leading] widget for non senders
• Added optional [trailing] widget for sender
• Added [margin] and [padding] properties
• Added tap callbacks such as [onTap], [onDoubleTap] and [onLongPress].
• Changes the texts to selectable texts

For BubbleNormalImage Widget

BubbleNormalImage Widget-

• Added optional [leading] widget for non senders
• Added optional [trailing] widget for sender
• Added [margin] and [padding] parameters
• Added Tap Callbacks such as [onTap] and [onLongPress].

For DateChip Widget

• Fixes [DateChip] taking full width

Other

• Updated the environment to allow support for latest dart sdks
• Updated the documentation within code to be easier to read

1.5.0 11/08/2023

• Customizable constrains for bubbles
• Customizable message bar hint text
• Customizable message bar hint style
• Update the example

1.4.1 26/01/2023

• Support up-to-date dependencies

1.4.0 29/12/2022

• Add BubbleNormalImage image chat bubble widget

1.3.1 16/08/2022

• Support up-to-date dependencies

1.3.0 03/07/2022

• Add MessageBar widget

1.2.0 04/02/2022

• Add iMessage's chat bubble shape bubble widget (BubbleSpecialThree).

1.1.0 27/06/2021

• Audio chat bubble widget(BubbleNormalAudio) for the bubble normal widget set.

1.0.0+3 16/05/2021

• Update README main example code.

1.0.0+2 15/05/2021

• dartfmt formatting.

1.0.0+1 15/05/2021

• dartfmt formatting.

1.0.0 15/05/2021

• Add DateChip widget

0.8.1 26/04/2021

• set priority for message status tick (seen > delivered > sent)

0.8.0+1 22/03/2021

• Update README.md example.

0.8.0 15/03/2021

• Add the option to customize the chat bubble text styles by changing textStyle parameter

0.7.9+3 10/03/2021

• null-safety.

0.7.8+2 21/10/2020

• dartfmt formatting.

0.7.8+1 20/07/2020

• Update README.md example.

0.7.8 20/07/2020

• Add message states(sent, delivered, seen) flag for BubbleSpecialOne and BubbleSpecialTwo.
• Update the example.

0.7.5+1 18/07/2020

• Add some dartdoc comments.

0.7.5 21/06/2020

• Add message states(sent, delivered, seen) flag for BubbleNormal.
• Update the example.

0.7.1+6 17/05/2020

• Update the example.

0.7.1+5 10/05/2020

• Update README.md file.

0.7.1+4 10/05/2020

• Update package description.

0.7.1+3 09/05/2020

• Update package description.

0.7.1+2 09/05/2020

• Update package description.

0.7.1+1 09/05/2020

• Update package description.

0.7.1 09/05/2020

• Update package description.

0.7.0 09/05/2020

• First release with an example.