badges

Bug Fixes

• Issue #114 — Fixed showBadge: false being ignored when a loop animation is active. didUpdateWidget now handles showBadge changes before any loop-animation guards.
• Issue #130 — 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.
• Issue #98 — Fixed border anti-aliasing artifact. Border is now drawn entirely inside the circle via strokeAlign: BorderSide.strokeAlignInside in BoxDecoration, preventing background-colour bleed at antialiased edges.
• Issue #115 (partial) — Key-based animation re-trigger: setting a Key on badgeContent and changing it now restarts the animation for any widget type, not just Text and Icon.

New Features

• 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).
• Minimum-square badge sizing — Single-character text and small-icon badges now maintain correct circular/square proportions (PR #111).
• BadgeGradient.gradient() asserts — Added assert statements documenting constructor invariants instead of silently force-unwrapping nullable fields.
• Controller duration updates — didUpdateWidget now updates AnimationController durations when badgeAnimation duration properties change.

Example App & Docs

• Fixed all lint warnings in example/ (use_super_parameters, prefer_final_fields, curly_braces_in_flow_control_structures, avoid_print, deprecated_member_use).
• README: fixed showcase GIF height (600px → 400px).
• README: added hide Badge import pattern (issue #123).
• Bumped flutter_lints to ^6.0.0.

• fix: revert commit 3.1.0 (#112)

• Revert "3.1.0 (#109)"

This reverts commit bdc035a

• Version update to 3.1.1 and changelog update

Co-authored-by: Daniyil Yakovlev [email protected]

• fix: remove .flutter-plugin-dependencies from .gitignore

• Version 3.1.2

Co-authored-by: Vitaliy Hnidenko [email protected]

• Update Dart SDK version. Update readme.

• Return to 3.0.3 version functionality due to bug

• Add BadgeShape.triangle
• 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

• Due to Badge widget introduction in Material library, the package is refatored to avoid ambiguous imports. badges.Badge used everywhere.
• Readme updated

Bump version to 3.0.1 and fix typo in the readme

fix: Change imports of badges lib everywhere because Material introdu…

[3.0.0-beta.1] - [Dec 25, 2022]

• Add onTap for Badge
• Add Twitter and Instagram shapes
• Add size, rotation and color change animation for Badge
• Add loop animation
• Add border gradient
• Add more customization for animation and style
• Breaking changes! Please check the readme for simple migration guide

• Add onTap for Badge
• Add Twitter and Instagram shapes
• Add size, rotation and color change animation for Badge
• Add loop animation
• Add border gradient
• Add more customization for animation and style
• Breaking changes! Please check the readme for simple migration guide

Version update to 2.0.3

• Fix border radius of the badge, when using it with gradient

• Add gradient parameter to the Badge
• Add BadgePosition.center() as a new factory constructor for the BadgePosition

• Add parameter to edit fit parameter Stack widget

• Null safety, finally! Prerelease

• Breaking change! Deprecated parameter 'Overflow' replaced with 'Clip' for Stack widget.
• Documentation implementation

• Fix error parameter with the name 'clipBehavior'

• Add borderSide parameter to customize the badge border
• Fix issue where null border radius was provided

• Migrate Android embedding v2, fix overflow issue
• Ignore pointer option for Badge
• Custom border radius for Badge

• 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 a bug when all the badges on the screen are animated if one of them is updated. Fixed only for badges that have Text or Icon in badge content.

• Updated versions in readme.

Images and description update

• Updated readme images and lib description.

• Badge class for creating badges for every widget.