chat_bubbles

Pre-release

Try it by pinning the exact version:

dependencies:
  chat_bubbles: 2.0.0-beta.1

Stable consumers on ^1.10.x are unaffected — pub.dev does not auto-upgrade across this pre-release.

What changed

Rewrote the five text bubbles (BubbleNormal, BubbleSpecialOne/Two/Three, BubbleReply) to render the message + meta block (timestamp, "Edited", sent/delivered/seen tick) through a single custom RenderBox. The meta is now anchored to the message's last-line baseline and rendered inline on the last line when it fits — the WhatsApp / iMessage layout — and drops to a right-aligned row below only when it doesn't.

Resolves #26.

Breaking changes

• SelectableText removed from the five text bubbles. Long-press text selection is no longer available out of the box. Use onLongPress to drive a copy menu (the platform convention) or wrap the bubble in SelectableRegion for full selection.
• BubbleLinkPreview is unchanged (its link-card sits between text and meta, so the inline layout doesn't apply).

Try it & report back

The new layout is sensitive to font metrics. If you see misalignment for a specific text style, please open an issue with a screenshot.

Plan

If feedback is positive, v2.0.0 will ship a few weeks after this beta.

Documentation

• Added llms.txt (AI-agent entry point following the llmstxt.org standard) and doc/recipes.md (8 copy-paste recipes for common scenarios) — both ship with the package so consumer-side AI tooling can discover the API
• Expanded CONTRIBUTING.md with development setup, test-suite instructions, and a PR checklist
• Added CLAUDE.md / AGENTS.md (symlink) covering common commands, layout, and gotchas for contributors

CI / tooling

• Added GitHub Actions workflow that runs dart format check, dart analyze --fatal-infos, flutter test, and flutter pub publish --dry-run on every push and PR to master/develop
• Added 47 widget and unit tests covering every public widget plus MessageGroupHelper and Algo.dateChipText
• Added scripts/release.sh to codify the publish flow into a single command
• Reformatted lib/ to match dart format defaults

New Features

• MessageBarStyle — new class that consolidates MessageBar appearance and input config: enabledBorder, focusedBorder, keyboardType, textCapitalization, contentPadding, fillColor, minLines, maxLines (thanks @herrytco, #64)
• MessageBar.sendButton — optional widget parameter to replace the default send icon with any custom widget (thanks @herrytco, #64)

Fixes

• Exported MessageBarStyle from chat_bubbles.dart so it is reachable by package consumers

Breaking

• Minimum supported SDK bumped to Dart 3.6 / Flutter 3.27 (required for Color.withValues())

Fixes

• Replaced deprecated Color.withOpacity() with Color.withValues(alpha: ...) across all bubble widgets to clear pana static-analysis warnings
• Migrated constructors to super-parameters ({super.key}) and removed an unnecessary library directive — clears 21 additional analyzer infos

• Synced full version of the package

• fix package oversized issue

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

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

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