Zeba Academy Hackathon Manager 🚀

A complete Flutter package for managing hackathon workflows including event creation, participant management, team formation, idea submission, project submission, judging, scoring, leaderboard and winner announcements.

Build scalable hackathon experiences using reusable Flutter components.

---

✨ Features

🏆 Hackathon Events

Create and manage hackathon events.

Features:

• Create hackathon
• Event details
• Start date
• End date
• Hackathon lifecycle management

---

👨‍💻 Participant Profiles

Manage hackathon participants.

Features:

• Participant information
• Skills tracking
• Email details
• Profile management

Example:

Participant(
 id: "1",
 name: "Sufyan",
 email: "sufyan@example.com",
 skill: "Flutter"
);

---

👥 Team Formation

Create and manage hackathon teams.

Features:

• Create teams
• Add members
• Manage team profiles

Example:

Team(
 id: "team1",
 name: "Flutter Warriors",
 members:[
   "participant1",
   "participant2"
 ]
);

---

💡 Idea Submission

Allow teams to submit hackathon ideas.

Features:

• Idea title
• Description
• Team mapping

Example:

HackathonIdea(
 id:"idea1",
 title:"Smart Education",
 description:"Learning platform",
 teamId:"team1"
);

---

🚀 Project Submission

Manage final projects.

Features:

• Project name
• Team submission
• Repository link

Example:

ProjectSubmission(
 id:"project1",
 teamId:"team1",
 projectName:"Mobile App",
 githubLink:"github.com/project"
);

---

👨‍⚖️ Judge Panel

Manage judges and evaluations.

Features:

• Judge profiles
• Project evaluation
• Team scoring

Example:

Judge(
 id:"judge1",
 name:"John"
);

---

⭐ Scoring System

Flexible hackathon scoring.

Supports:

• Innovation score
• Design score
• Execution score
• Automatic total calculation

Example:

Score(
 teamId:"team1",
 innovation:90,
 design:85,
 execution:95
);

Result:

Total Score: 270

---

🥇 Leaderboard

Automatic ranking system.

Features:

• Score sorting
• Ranking display
• Winner calculation

Example:

controller.leaderboard();

---

🎉 Winner Announcement

Find winning teams.

Example:

controller.winner();

Output:

Winning Team ID

---

📦 Installation

Add package:

dependencies:

 zeba_academy_hackathon_manager:
   path: ../zeba_academy_hackathon_manager

Run:

flutter pub get

---

🚀 Usage

Import package:

import 
'package:zeba_academy_hackathon_manager/zeba_academy_hackathon_manager.dart';

Create manager:

final manager = HackathonController();

Add participant:

manager.addParticipant(

 Participant(
  id:"1",
  name:"Alex",
  email:"alex@email.com",
  skill:"Flutter"
 )

);

Create team:

manager.createTeam(

 Team(
  id:"1",
  name:"Developers",
  members:[
    "1"
  ]
 )

);

Add score:

manager.addScore(

 Score(
  teamId:"1",
  innovation:95,
  design:90,
  execution:92
 )

);

Get leaderboard:

manager.leaderboard();

Get winner:

manager.winner();

---

📁 Project Structure

lib/

├── models/

│── hackathon.dart
│── participant.dart
│── team.dart
│── idea.dart
│── project.dart
│── judge.dart
│── score.dart


├── controllers/

│── hackathon_controller.dart


├── widgets/

│── hackathon_card.dart
│── leaderboard_card.dart
│── score_card.dart


└── screens/

 ├── hackathon_dashboard.dart
 └── leaderboard_screen.dart

---

🎯 Why Use This Package?

✅ Pure Flutter package ✅ No API dependency ✅ No Firebase dependency ✅ Lightweight ✅ Reusable architecture ✅ Developer friendly ✅ Open source

---

Requirements

Flutter:

>=3.0.0

Dart:

>=3.0.0 <4.0.0

---

Roadmap

Future improvements:

• Certificate generator
• Prize management
• Sponsor section
• Hackathon timer
• Voting system
• Export reports
• Offline storage
• Dark mode UI
• Animated leaderboard

---

About Me

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

Learn more:

🌐 https://sufyanism.com/

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

---

Zeba Academy 🚀

Your all-in-one learning hub!

Explore:

• Coding
• Technology
• Development
• Real-world projects

Website:

https://zeba.academy

Courses:

https://code.zeba.academy

YouTube:

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

Instagram:

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

---

Contributing

Contributions are welcome.

Steps:

git clone repository

git checkout -b feature/new-feature

git commit -m "Add feature"

git push origin feature/new-feature

Create a Pull Request.

---

License

Licensed under the GNU General Public License v3.0.

You are free to:

• Use
• Modify
• Share
• Distribute

Under GPL-3.0 conditions.

---

Made with ❤️ using Flutter

Zeba Academy Hackathon Manager