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