zeba_academy_project_builder 🚀

A Flutter package for building and managing software projects with roadmaps, tasks, milestones, progress tracking, and project showcases.

Create structured development workflows, learning projects, and developer portfolios using reusable Flutter components.

Flutter Dart License

✨ Features

  • ✅ Project roadmap management
  • ✅ Task management
  • ✅ Milestone planning
  • ✅ Progress tracking
  • ✅ Showcase projects
  • ✅ Reusable Flutter widgets
  • ✅ Clean package architecture
  • ✅ Developer friendly APIs

📦 Installation

Add the package to your pubspec.yaml:

dependencies:
  zeba_academy_project_builder: ^1.0.0

Run:

flutter pub get

🚀 Getting Started

Import the package:

import 'package:zeba_academy_project_builder/zeba_academy_project_builder.dart';

📌 Create Project

final project = ProjectModel(

  id: "project_1",

  title: "Flutter Portfolio App",

  description:
      "Build a professional developer portfolio",

  tasks: [

    TaskModel(
      id: "task_1",
      title: "Create UI",
      completed: true,
    ),

    TaskModel(
      id: "task_2",
      title: "Add animations",
    ),

  ],

);

📊 Progress Tracking

The package automatically calculates project progress.

double progress = project.progress;

print(progress);

Example output:

0.5

✅ Tasks

Create project tasks:

TaskModel(

 id: "task_1",

 title: "Build Dashboard",

 completed:false,

);

Update task:

controller.updateTask(
 "project_id",
 "task_id",
);

🗺️ Project Roadmap

Create development roadmaps:

RoadmapModel(

 title:"Mobile Development",

 steps:[

  "Planning",

  "Design",

  "Development",

  "Testing",

 ]

);

🏁 Milestones

Create milestones:

MilestoneModel(

 id:"milestone_1",

 title:"First Release",

 deadline:
 DateTime.now(),

);

🎨 Showcase Projects

Display completed projects:

ShowcaseModel(

 projectName:
 "Flutter Application",

 imageUrl:
 "https://example.com/image.png",

 githubUrl:
 "https://github.com/example",

);

🧩 Widgets Included

ProgressCard

ProgressCard(
 progress:0.75,
)

TaskTile

TaskTile(

 title:"Complete UI",

 completed:true,

 onTap:(){},

)

MilestoneCard

MilestoneCard(

 title:"Version 1.0",

 date:DateTime.now(),

)

ShowcaseCard

ShowcaseCard(

 title:"My Project",

 image:"image_url",

)

📁 Package Structure

lib/

├── zeba_academy_project_builder.dart

├── models/

│   ├── project_model.dart

│   ├── roadmap_model.dart

│   └── showcase_model.dart


├── controllers/

│   └── project_controller.dart


└── widgets/

    ├── progress_card.dart

    ├── task_tile.dart

    ├── milestone_card.dart

    └── showcase_card.dart

🧪 Testing

Run tests:

flutter test

Analyze:

flutter analyze

🤝 Contributing

Contributions are welcome.

Steps:

  1. Fork the repository

  2. Create a branch:

git checkout -b feature/new-feature
  1. Commit:
git commit -m "Add new feature"
  1. Push:
git push origin feature/new-feature
  1. 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!

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

Learn through:

  • Coding tutorials
  • Practical projects
  • Development resources
  • Hands-on experience

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 v3.0

You are free to:

  • Use
  • Modify
  • Share
  • Distribute

under GPL-3.0 terms.

See the LICENSE file for full license details.

⭐ Support

If this package helps you:

⭐ Star the repository ⭐ Share it with developers ⭐ Contribute improvements

Thank you for using:

zeba_academy_project_builder ❤️

Libraries

zeba_academy_project_builder