zeba_academy_skill_tree

A powerful Flutter package for building interactive skill trees and learning paths with unlockable nodes, dependency management, learning tracks, and visual progress tracking.

Perfect for:

🎓 E-learning platforms
📚 Course progression systems
🧠 Skill roadmap applications
🎮 Gamified education
🏆 Achievement systems
🚀 Learning journey experiences

Features

✅ Unlockable skill nodes ✅ Dependency-based progression ✅ Learning tracks support ✅ Progress visualization ✅ Custom node styling ✅ Responsive layouts ✅ State management ready ✅ Smooth animations ✅ Lightweight architecture ✅ Easy integration

Preview

Basics
   ↓
Widgets
   ↓
State Management
   ↓
Advanced Flutter

Installation

Add dependency:

dependencies:
  zeba_academy_skill_tree: latest

Install:

flutter pub get

Import:

import 'package:zeba_academy_skill_tree/zeba_academy_skill_tree.dart';

Quick Start

Create Nodes

final nodes = [

SkillNode(
id: '1',
title: 'Basics',
icon: Icons.school,
status: SkillStatus.unlocked,
),

SkillNode(
id: '2',
title: 'Widgets',
icon: Icons.widgets,
dependencies: ['1'],
),

SkillNode(
id: '3',
title: 'State',
icon: Icons.memory,
dependencies: ['2'],
),

];

Setup Controller

final controller =
SkillTreeController(
nodes,
);

Build UI

ChangeNotifierProvider(

create: (_) => controller,

child: const SkillTree(),

)

Unlock Logic

A node becomes available only after all dependency nodes are completed.

Example:

Course A
   ↓
Course B
   ↓
Course C

Complete A → unlock B Complete B → unlock C

Progress Tracking

Track user completion percentage automatically.

controller.totalProgress

Update progress:

controller.updateProgress(
'2',
0.6,
);

Complete node:

controller.complete(
'2',
);

Learning Tracks

Group nodes into structured paths.

SkillTrack(

title: 'Flutter Mastery',

nodes: [

basics,
widgets,
state,

],

);

Example

MaterialApp(

home: Scaffold(

appBar: AppBar(
title: const Text(
'Skill Tree',
),

),

body: const SkillTree(),

),

);

Package Structure

lib/

models/
 ├── skill_node.dart
 └── skill_track.dart

controllers/
 └── skill_tree_controller.dart

widgets/
 ├── skill_tree.dart
 ├── progress_header.dart
 └── skill_node_widget.dart

utils/
 └── unlock_engine.dart

Roadmap

Zoomable tree
Drag interactions
Firebase sync
XP system
Achievements
Node animations
Offline persistence
Riverpod support
Analytics

Contributing

Contributions are welcome.

Fork repository
Create branch

git checkout -b feature/new-feature

Commit changes

git commit -m "Add feature"

Push

git push origin feature/new-feature

Open Pull Request

License

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

See the LICENSE file for 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:

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

Your all-in-one learning hub!

🚀 Explore courses and resources in coding, tech, and development at Zeba Academy.

Empower yourself with practical skills through curated tutorials, real-world projects, and hands-on experience.

🌐 https://zeba.academy 💻 https://code.zeba.academy ▶ https://www.youtube.com/@zeba.academy 📸 https://www.instagram.com/zeba.academy/

Thank you for visiting ❤️