zeba_academy_widget_diff_engine 0.0.1

A Flutter debugging tool to detect UI changes between widget rebuilds, compare widget trees, and visualize unnecessary rebuilds with a lightweight overlay.

Changelog

All notable changes to this project will be documented in this file.

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

---

0.0.1 Initial Release

✨ Added

• Initial release of zeba_academy_widget_diff_engine

• Widget tree capture system

• Recursive widget tree builder

• Widget diff comparison engine

• Detection of:

  • Type changes
  • Key changes
  • Added widgets
  • Modified widgets

• Lightweight debug overlay

• Change count visualization

• Debug logger utility

🧪 Testing

• Unit tests for diff engine
• Tree comparison validation
• Change detection scenarios covered

⚙️ Developer Experience

• Easy-to-use WidgetDiffDebugger wrapper
• Minimal setup integration
• Debug-only usage support

📌 Notes

• Designed for development/debugging purposes only
• Not recommended for production usage
• Future updates will include visual highlights and DevTools integration

---

🚀 Upcoming

Planned Features

• Visual bounding box highlights for changed widgets
• Color-coded diff (added / removed / updated)
• Rebuild performance heatmap
• Frame-by-frame diff timeline
• Flutter DevTools integration

---

📄 License

This project is licensed under the GNU General Public License v3.0 (GPL-3.0).