zeba_academy_user_behavior 0.0.1

A lightweight Flutter package to track user behavior including tap heatmaps, scroll depth, rage click detection, and basic session replay for analytics and UX optimization.

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 - 2026-04-04

🎉 Initial Release

✨ Added

• Tap tracking system for capturing user interaction coordinates

• Scroll depth tracking using ScrollNotification

• Rage click detection (multiple taps in a short duration within a small area)

• Basic session replay system to log and export user events

• Session management with unique session ID and start time

• Callback support for:

  • Tap events
  • Scroll percentage tracking
  • Rage click detection

🧠 Core Components

• BehaviorTracker for capturing taps and integrating rage detection
• ScrollTracker for monitoring scroll depth
• RageClickDetector for detecting frustration patterns
• SessionReplay for logging and exporting interaction events
• SessionManager for handling session lifecycle

⚙️ Improvements

• Optimized event tracking with minimal performance overhead
• Modular architecture for easy extensibility
• Clean and analyzer-friendly code (no warnings)

🧪 Testing

• Designed with callback-based architecture for easy unit and widget testing

---

🔮 Upcoming (Planned)

🚀 Next Versions

• Heatmap visualization UI
• Advanced session replay (visual playback)
• Backend integration support (Firebase / REST APIs)
• Event batching and performance optimizations
• Analytics dashboard support

---

Built with ❤️ by Zeba Academy