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.

Flutter Dart License

āœØ 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
  1. Commit changes
git commit -m "Add new feature"
  1. Push
git push origin feature/new-feature
  1. 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 šŸ’™

Libraries

zeba_academy_learning_avatar