🔥 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:

💡 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 ❤️