Zeba Academy Learning Avatar 🚀 #

A powerful Flutter package for creating gamified learning identities with customizable avatars, XP progression, achievements, unlockable items, and smooth animations.

Build engaging educational experiences where learners can create their identity, earn rewards, level up, and stay motivated.

✨ Features #

🎨 Avatar Creation #

Create personalized learner avatars.

Features:

• Avatar profile
• Custom learner name
• Avatar image support
• Animated avatar presentation

⭐ XP & Level System #

Reward learners with experience points.

Features:

• XP tracking
• Automatic level calculation
• Progress indicators
• Level-based growth system

Example:

controller.addXP(100);

🔓 Unlockable Items #

Keep learners motivated with collectible items.

Features:

• Custom rewards
• Level requirements
• Unlock tracking

Example:

controller.unlockItem(
 "Golden Badge"
);

🏆 Achievements #

Create achievement-based learning milestones.

Features:

• Achievement cards
• Unlock states
• Progress rewards

Example:

AchievementModel(

title:"First Course",

description:
"Completed first course",

unlocked:true,

);

🧑‍💻 Learning Identity #

Represent learners with a digital identity.

Includes:

• Username
• Avatar
• Level
• XP
• Rewards

🎬 Animations #

Built-in Flutter animations:

• Avatar transitions
• XP progress animation
• Smooth UI updates
• Level-up effects

📦 Installation #

Add dependency:

dependencies:

  zeba_academy_learning_avatar:

    git:
      url: https://github.com/your_username/zeba_academy_learning_avatar.git

or from pub.dev:

dependencies:

  zeba_academy_learning_avatar: ^1.0.0

Run:

flutter pub get

🚀 Usage #

Import package:

import 'package:zeba_academy_learning_avatar/
zeba_academy_learning_avatar.dart';

Create Avatar #

final avatar =
AvatarModel.initial();


AvatarView(

avatar: avatar,

);

Add XP #

final controller =
AvatarController();


controller.addXP(50);


print(
controller.avatar.level
);

Create Avatar Builder #

AvatarBuilder(

onChanged:(name){

print(name);

},

);

Display XP Progress #

XPBar(

xp:
controller.avatar.xp,

);

Achievement Example #

AchievementCard(

achievement:

AchievementModel(

title:
"Fast Learner",

description:
"Completed 10 lessons",

unlocked:true,

),

);

🏗 Project Structure #

lib/

├── zeba_academy_learning_avatar.dart

├── models/

│   ├── avatar_model.dart

│   ├── achievement_model.dart

│   └── item_model.dart


├── controllers/

│   └── avatar_controller.dart


├── widgets/

│   ├── avatar_view.dart

│   ├── avatar_builder.dart

│   ├── xp_bar.dart

│   └── achievement_card.dart

🎯 Use Cases #

Perfect for:

• Learning apps
• Coding platforms
• E-learning systems
• Gamified classrooms
• Student dashboards
• Coding challenges
• Skill tracking apps

🔥 Roadmap #

Future improvements:

• ❌ Avatar customization engine
• ❌ Cloud profile sync
• ❌ More animations
• ❌ Avatar marketplace
• ❌ Leaderboards
• ❌ Daily rewards
• ❌ Achievement notifications

🤝 Contributing #

Contributions are welcome!

Steps:

1. Fork repository

2. Create feature branch

git checkout -b feature/new-feature

3. Commit changes

git commit -m "Add new feature"

4. Push

git push origin feature/new-feature

5. Create Pull Request

📜 License #

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

You are free to:

✅ Use
✅ Modify
✅ Distribute
✅ Improve

Under GPL-3.0 terms.

See:

LICENSE

👨‍💻 About Me #

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

Learn more about my work:

🌐 https://sufyanism.com/

Connect:

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

🎓 Zeba Academy #

Your all-in-one learning hub!

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

Build practical skills through:

• Curated tutorials
• Real-world projects
• Hands-on learning

Visit:

🌐 Main platform:

https://zeba.academy

💻 Coding resources:

https://code.zeba.academy

📺 YouTube:

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

📸 Instagram:

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

⭐ Support #

If this package helps your project:

• Star the repository
• Share with developers
• Contribute improvements

Thank you for using Zeba Academy Learning Avatar 💙