Zeba Academy Reward Center #

A powerful, customizable, and developer-friendly Flutter package for building gamified reward systems in your applications.

Easily integrate points, badges, achievements, reward catalogs, and user levels into educational platforms, e-learning apps, communities, productivity tools, fitness applications, loyalty programs, games, and more.

✨ Features #

• 🎯 Points Management
• 🏅 Badge System
• 🏆 Achievement Engine
• 🎁 Reward Catalog
• 📈 User Levels
• 📦 Lightweight and Modular
• 🎨 Ready-to-use Flutter Widgets
• ⚡ Fast and Easy Integration
• 🔒 Null Safety Support
• ❤️ Clean API
• 🧪 Unit Test Friendly
• 🌐 Works Offline
• 🔥 Firebase Ready
• 📱 Android, iOS, Web, Windows, Linux & macOS Support

Platform Support #

Installation #

Add the package to your project.

dependencies:
  zeba_academy_reward_center: latest

Then run

flutter pub get

Import

import 'package:zeba_academy_reward_center/zeba_academy_reward_center.dart';

Features Overview #

⭐ Points System #

Reward users for completing actions.

final user = RewardUser(
  id: "1",
  name: "John",
);

final updated =
    PointsService().addPoints(user, 100);

print(updated.points);

🏅 Badge System #

Unlock badges when users reach milestones.

const badge = RewardBadge(
  id: "starter",
  title: "Starter",
  description: "First Badge",
  icon: "🏅",
);

final updated =
    BadgeService().unlockBadge(user, badge);

🏆 Achievement System #

Track accomplishments.

const achievement = Achievement(
  id: "100",
  title: "100 Points",
  description: "Earn 100 points",
  requiredPoints: 100,
);

AchievementService().check(
  user,
  achievement,
);

🎁 Reward Catalog #

Redeem rewards using earned points.

const reward = RewardItem(
  id: "coffee",
  name: "Coffee Coupon",
  description: "Free Coffee",
  cost: 200,
);

RewardService().redeem(
  user,
  reward,
);

📈 User Levels #

Automatically calculate user levels.

final level =
    LevelService().getLevel(user.points);

print(level.title);

Included Models #

RewardUser #

RewardUser(
  id: "1",
  name: "John",
  points: 250,
  badges: [],
  achievements: [],
)

RewardBadge #

RewardBadge(
  id: "gold",
  title: "Gold Member",
  description: "Reach Gold Level",
  icon: "🥇",
)

Achievement #

Achievement(
  id: "1000",
  title: "1000 Points",
  description: "Earn 1000 points",
  requiredPoints: 1000,
)

RewardItem #

RewardItem(
  id: "gift",
  name: "Gift Card",
  description: "Amazon Gift Card",
  cost: 500,
)

UserLevel #

UserLevel(
  level: 3,
  title: "Pro",
  requiredPoints: 1000,
)

Included Services #

Widgets #

The package includes reusable widgets.

• PointsCard
• BadgeCard
• LevelProgress

Example

PointsCard(
  points: 500,
)

Complete Example #

import 'package:flutter/material.dart';
import 'package:zeba_academy_reward_center/zeba_academy_reward_center.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    final user = RewardUser(
      id: "1",
      name: "Alice",
    );

    final updated =
        PointsService().addPoints(user, 250);

    final level =
        LevelService().getLevel(updated.points);

    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text("Reward Center"),
        ),
        body: Column(
          children: [
            PointsCard(
              points: updated.points,
            ),
            LevelProgress(
              current: updated.points,
              target: 1000,
            ),
            Text(level.title),
          ],
        ),
      ),
    );
  }
}

Roadmap #

• Daily Rewards
• Login Rewards
• Streak Rewards
• XP System
• Leaderboards
• Reward History
• Coupon Support
• Digital Rewards
• Animated Widgets
• Firebase Integration
• Riverpod Integration
• Bloc Integration
• Localization
• Theme Customization
• Achievement Notifications

Why Use This Package? #

• Simple API
• Clean Architecture
• Modular Design
• Production Ready
• Lightweight
• Easily Extendable
• Flutter Best Practices
• Null Safety
• Highly Customizable

Contributing #

Contributions are welcome.

If you discover bugs, have feature requests, or would like to contribute improvements, feel free to open an issue or submit a pull request.

Please ensure your code follows Dart and Flutter best practices.

License #

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

You are free to:

• Use
• Modify
• Distribute
• Study

under the terms of the GPL v3 License.

See the LICENSE file for complete details.

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 https://sufyanism.com/ or connect with me on LinkedIn:

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

Your all-in-one learning hub! #

🚀 Explore courses and resources in coding, technology, and software development.

Zeba Academy #

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

🌐 Website
https://zeba.academy

💻 Learning Platform
https://code.zeba.academy

▶️ YouTube
https://www.youtube.com/@zeba.academy

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

Support #

If you find this package helpful, please consider:

• ⭐ Starring the repository
• 👍 Liking and sharing
• 🐞 Reporting issues
• 💡 Suggesting new features
• 🤝 Contributing to development

Every contribution helps improve the project for the Flutter community.

Made with ❤️ using Flutter.

Happy Coding! 🚀