zeba_user_tracker

🚀 A lightweight Flutter user tracking and analytics toolkit to help developers monitor user interactions and gain insights into app behavior.

zeba_user_tracker provides tools for tracking taps, scrolls, session events, heatmaps, and funnel analysis — all in one easy-to-use package.

✨ Features

  • 🔴 Heatmap Overlay – Visualize user taps in real-time
  • 🔁 Session Recorder – Track taps, scrolls, and user sessions
  • 📊 Funnel Tracker – Analyze user journeys and drop-off rates
  • 🖥 Analytics Dashboard – Review session events, heatmaps, and funnel metrics
  • 📁 Local Storage – Store analytics offline using JSON and SharedPreferences

📦 Installation

Add this package to your pubspec.yaml.

dependencies:
  zeba_user_tracker: ^1.0.0

Then run:

flutter pub get

🚀 Getting Started

Import the package:

import 'package:zeba_user_tracker/zeba_user_tracker.dart';

🔴 Heatmap Overlay

Wrap your app with HeatmapOverlay to track and display taps.

done
HeatmapOverlay(
  child: MyApp(),
)

🔁 Session Recorder

Wrap your app with SessionRecorder to track scrolls, taps, and session events.

SessionRecorder(
  child: MyApp(),
)

📊 Funnel Tracker

Track screen visits and drop-offs:

final tracker = ZebaUserTracker();
tracker.funnelTracker.screenVisited("HomeScreen");
tracker.funnelTracker.userExited("HomeScreen");

Compute drop-off rates:

double rate = tracker.funnelTracker.dropOffRate("HomeScreen");
print("Drop-off: \$rate%");

🖥 Analytics Dashboard

View session events, heatmaps, and funnel data:

Navigator.push(
  context,
  MaterialPageRoute(
    builder: (_) => const ZebaAnalyticsDashboard(),
  ),
);

🧪 Testing

Run tests using:

flutter test

🤝 Contributing

Contributions are welcome!

  1. Fork the repository
  2. Create a feature branch
  3. Submit a pull request

📜 License

This project is licensed under the GNU General Public License v3.0.

About Me

✨ I’m Sufyan bin Uzayr, an open-source developer passionate about building and sharing meaningful projects. You can learn more about me and my work at sufyanism.com or connect with me on Linkedin

Your all-in-one no-bloat hub!

🚀 Explore cutting-edge resources in coding, tech, and development at zeba.academy and code.zeba.academy. Empower yourself with practical skills through curated directives, real-world projects, and hands-on experience. Level up your tech game today! 💻✨

Zeba Academy is a learning platform dedicated to coding, technology, and development.

➡ Visit our main site: https://zeba.academy ➡ Explore hands-on courses and resources at: https://code.zeba.academy ➡ Check out our YouTube for more tutorials: https://www.youtube.com/@zeba.academy ➡ Follow us on Instagram: https://www.instagram.com/zeba.academy/

⭐ If you find this package useful, consider giving it a star and sharing it with the community!

Thank you for visiting!

Libraries

zeba_academy_user_tracker