NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev · #667 most downloaded on pub.dev
A package for creating badges. Badges can be used for an additional marker for any widget, e.g. show a number of items in a shopping cart.
Last release 12 days ago
26 Sep 2026
Ships unpredictably
gaps range from 3 weeks to 2.6 years
Most releases are documented
notes for 24 of 30 stable releases
Nothing withdrawn
no release was ever pulled
8 years old
32 releases · first in 2018
Co-authored-by: Claude Opus 5.5 noreply@anthropic.com
Co-authored-by: Claude Opus 5.5 noreply@anthropic.com
Replaced SizeTransition.axisAlignment , deprecated after Flutter v3.41, with alignment . BadgeAnimation.sizeTransitionAxisAlignment is unchanged and s…
package:material_ui (#135, thanks @mayainle) — Material and Cupertino were decoupled from the Flutter SDK in Flutter 3.47 and now ship as standalone packages. This package now imports package:material_ui/material_ui.dart instead of package:flutter/material.dart.
material_ui, badge content now gets the app's theme text style without MaterialUiCompatibilityBridge. Apps still on package:flutter/material.dart keep working, but badge text uses the default Material text style until they migrate. This is a major version bump, as the Flutter team recommends for this migration.Badge, use import 'package:material_ui/material_ui.dart' hide Badge; instead of the Flutter Material equivalent.3.13.0 / Flutter 3.47.0, the floor required by material_ui.ignorePointer docs said the opposite of what it does. true lets taps pass through the badge; false (default) lets the badge get taps.BadgeStyle.elevation works again. It has drawn no shadow since 3.0.3. The default is now 0, so badges that don't set it look the same as before.BadgePosition.center() with onTap no longer moves the badge to the top-left corner.BadgePosition.centerStart() / centerEnd() are now vertically centered, as documented.onTap no longer shift the badge. The tap padding is now directional.showBadge: false) no longer catch taps or call onTap; taps reach the widget below.stops, tileMode, sweep angles and directional alignments are now used.toAnimate on at runtime no longer leaves the badge invisible.ConstrainedBox. The 3.2.0 "minimum-square sizing" note was wrong: badge sizing did not change in 3.2.0 and does not change now.SizeTransition.axisAlignment, deprecated after Flutter v3.41, with alignment. BadgeAnimation.sizeTransitionAxisAlignment is unchanged and still takes a double..pubignore).onTap padding and ignorePointer.Install: flutter pub add badges (needs Flutter 3.47+ / Dart 3.13+). Apps on older Flutter keep getting 3.2.0.
Full changelog: v3.2.0...v4.0.0
One column per quarter.
…avoid_print, deprecated_member_use).
showBadge: false being ignored when a loop animation is active. didUpdateWidget now handles showBadge changes before any loop-animation guards.showBadge: false now hides the badge immediately. _animationController.stop() and _appearanceController.stop() are called before reverse() so the badge does not wait for the animation to play through.strokeAlign: BorderSide.strokeAlignInside in BoxDecoration, preventing background-colour bleed at antialiased edges.Key on badgeContent and changing it now restarts the animation for any widget type, not just Text and Icon.BadgeStyle.copyWith — Returns a copy of a BadgeStyle with overridden fields.BadgePosition.centerStart — New named constructor: badge vertically centered on the start (left) side.BadgePosition.centerEnd — New named constructor: badge vertically centered on the end (right) side.BadgeState.animationController / appearanceController getters — Public access to the internal animation controllers for advanced use cases (PR #128)._BadgeVisual private widget — Extracted badge visual from an inner closure into a proper StatelessWidget so Flutter's element tree can cache it and avoid rebuilding the full subtree on every opacity tick (PR #120).BadgeGradient.gradient() asserts — Added assert statements documenting constructor invariants instead of silently force-unwrapping nullable fields.didUpdateWidget now updates AnimationController durations when badgeAnimation duration properties change.example/ (use_super_parameters, prefer_final_fields, curly_braces_in_flow_control_structures, avoid_print, deprecated_member_use).600px → 400px).hide Badge import pattern (issue #123).flutter_lints to ^6.0.0.Version update to 3.1.1 and changelog update
This reverts commit bdc035a
Co-authored-by: Daniyil Yakovlev danny.yakovlev@gmail.com
fix: remove .flutter-plugin-dependencies from .gitignore
Version 3.1.2
Co-authored-by: Vitaliy Hnidenko 82770717+sawel24@users.noreply.github.com
Return to 3.0.3 version functionality due to bug
Fix custom shapes deformation depending on the badge content
Fix transparent color for the badge
Bump version to 3.0.2 and fix typo in the readme
Bump version to 3.0.2 and fix typo in the readme
Bump version to 3.0.1 and fix typo in the readme
Bump version to 3.0.1 and fix typo in the readme
fix: Change imports of badges lib everywhere because Material introdu…
fix: Change imports of badges lib everywhere because Material introdu…
Breaking changes! Please check the readme for simple migration guide
Version update to 2.0.3
Version update to 2.0.3
Add gradient parameter to the Badge
gradient parameter to the BadgeBadgePosition.center() as a new factory constructor for the BadgePositionAdd parameter to edit fit parameter Stack widget
Null safety, finally! Prerelease
Breaking change! Deprecated parameter 'Overflow' replaced with 'Clip' for Stack widget.
Fix error parameter with the name 'clipBehavior'
Add borderSide parameter to customize the badge border
Migrate Android embedding v2, fix overflow issue
Fix for deprecated overflow parameter on Stack widget
Add alignment parameter to define position of the whole widget
Added showBadge parameter to hide or show badge with animation
Fixed animation for all badges even if only one is updated. Fixed onl…
Fixed animation for all badges even if only one is updated. Fixed onl…
* Updated versions in readme.
Images and description update
Images and description update
Badge class for creating badges for every widget.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →