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.

✨ 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

3. Commit:

git commit -m "Add new feature"

4. Push:

git push origin feature/new-feature

5. 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 ❤️