🔥 Zeba Academy Streak

A Flutter package for creating learning streak systems with daily progress tracking, calendar heatmaps, rewards, and motivation widgets.

Build engaging education experiences by helping users maintain consistent daily learning habits.

📌 Package Information

Package Name

zeba_academy_streak

Version

1.0.0

License

GPL-3.0

✨ Features

🔥 Daily Streak Tracking

Track user learning consistency.

Features:

  • Daily activity completion
  • Automatic streak calculation
  • Current streak counter
  • Learning progress tracking

📅 Calendar Heatmap

Visualize learning activity like GitHub contribution graphs.

Features:

  • Completed days display
  • Missed days tracking
  • Activity visualization
  • Customizable UI

🏆 Reward System

Motivate users with achievement milestones.

Built-in rewards:

Days Reward
7 Days Starter
30 Days Master
100 Days Legend

💡 Motivation Widgets

Ready-to-use widgets:

  • Motivation cards
  • Streak counter
  • Progress displays

🚀 Installation

Add dependency:

dependencies:
  zeba_academy_streak: ^1.0.0

Run:

flutter pub get

📦 Import

import 'package:zeba_academy_streak/zeba_academy_streak.dart';

🔥 Usage

Create Controller

final streak =
    StreakController(
      history: [],
    );


streak.markToday();

📊 Display Streak Counter

StreakCounter(
  controller: streak,
)

Example:

Learning Streak

🔥 5 Days

📅 Heatmap Widget

StreakHeatmap(
  days: streak.history,
)

Shows:

  • Learning activity
  • Completed days
  • Progress history

💬 Motivation Card

MotivationCard(
 message:
 "Keep learning every day 🚀",
)

🏆 Rewards

Check unlocked reward:

final reward =
    streak.reward();


if(reward != null){

 print(
 reward.title
 );

}

📂 Folder Structure

zeba_academy_streak

lib/

├── models/

│   ├── streak_day.dart
│   └── streak_reward.dart


├── controllers/

│   └── streak_controller.dart


├── widgets/

│   ├── streak_counter.dart
│   ├── streak_heatmap.dart
│   └── motivation_card.dart


└── zeba_academy_streak.dart

🎯 Use Cases

Perfect for:

  • Learning apps
  • Coding practice platforms
  • Course applications
  • Quiz apps
  • Student dashboards
  • Habit trackers
  • Education platforms

🛠 Requirements

Flutter:

>=3.10.0

Dart:

>=3.12.0

🧪 Testing

Run tests:

flutter test

Analyze package:

flutter analyze

🤝 Contributing

Contributions are welcome.

Steps:

git checkout -b feature/new-feature

Make changes.

Commit:

git commit -m "Add new feature"

Push:

git push origin feature/new-feature

Create Pull Request.

👨‍💻 About Me

✨ I’m Sufyan bin Uzayr, an open-source developer passionate about building and sharing meaningful projects.

Learn more:

🌐 Website

https://sufyanism.com/

💼 LinkedIn

https://www.linkedin.com/in/sufyanism

🚀 Zeba Academy

Your all-in-one learning hub!

Zeba Academy is a learning platform focused on coding, technology, and development.

Explore:

🌐 Main Website

https://zeba.academy

💻 Coding Resources

https://code.zeba.academy

▶ YouTube

https://www.youtube.com/@zeba.academy

📸 Instagram

https://www.instagram.com/zeba.academy/

📄 License

This project is licensed under:

GNU GENERAL PUBLIC LICENSE
Version 3 (GPL-3.0)

You are free to:

✅ Use ✅ Modify ✅ Study ✅ Share ✅ Distribute

Under the terms of GPL-3.0.

Full license:

https://www.gnu.org/licenses/gpl-3.0.html

⭐ Support

If this package helps your project:

⭐ Star the repository

🤝 Contribute

📢 Share with developers

Thank you for supporting open-source ❤️

Libraries

zeba_academy_streak