zeba_academy_badge_kit 0.1.0

A lightweight, customizable Flutter badge package supporting dot badges, counters, animations, and position control for any widget.

Changelog

All notable changes to Zeba Academy Badge will be documented in this file.

The format is based on Keep a Changelog,
and this project follows Semantic Versioning.

---

0.1.0 - 2026-07-02

🎉 Initial Release

This is the first production-ready release of Zeba Academy Badge.

✨ Added

• 🔔 Notification counter badge support
• 🔴 Dot badge mode (showDot)
• 📍 Badge position control:
  • topLeft
  • topRight
  • bottomLeft
  • bottomRight
• 🎬 Smooth scale animation on badge updates
• 🎯 Support for any widget (Icon, Image, Avatar, Button, etc.)
• 📊 Max count display support (e.g. 99+)
• 🎨 Customizable badge style:
  • color
  • text color
  • padding
  • border radius
  • font size
  • shadow toggle
• ⚡ Lightweight and easy-to-use API

🧠 Changed

• Structured package into production-ready architecture:
  • badge.dart
  • badge_style.dart
  • badge_position.dart

🧪 Testing

• Added widget tests for:
  • Counter badge rendering
  • Dot badge rendering
  • Zero-count visibility handling

---

[Unreleased]

🚧 Planned Features

• 🔥 Pulse animation (WhatsApp-style notification effect)
• 🎯 Stream/real-time badge updates support
• 📈 Animated number transitions
• 🌈 Gradient badge styles
• 🧩 Badge overlay builder API
• ⚙️ Riverpod/Bloc integration helpers
• 📱 Accessibility improvements (screen readers support)

---

📌 Notes

• Breaking changes will always be documented in major version updates
• Minor versions will add features in a backward-compatible way
• Patch versions will include bug fixes and improvements