ezerssss / komshat

Weekly Hackathon

Komshat: UP Visayas ComSci Hackathons

Komshat is a platform developed specifically for organizing hackathons tailored for UP Visayas Computer Science students. The unique aspect of these hackathons is that each theme is generated using artificial intelligence (AI), ensuring fresh and innovative challenges for participants.

Features

• AI-Generated Themes: Themes for each hackathon are automatically generated by AI, providing diverse and engaging prompts for participants.
• Autonomous Platform: The platform operates with minimal administrative supervision, enabling seamless participation and project submissions.

Tech Stack

• Frontend: Next.js, Tailwind CSS, shadcn/ui components.
• Backend: Firebase Cloud Functions, Firestore for database operations, Google Cloud Scheduler for Cron jobs, Google Cloud Tasks Services.
• Authentication: Firebase Authentication for secure user management.
• Storage: Firebase Storage for managing project uploads.
• AI Integration: OpenAI API for theme generation.

Contributing

Contributions to Komshat are encouraged! If you have ideas for enhancements, feature requests, or bug fixes:

1. Fork the repository.
2. Create a new branch for your feature or bug fix:

   git checkout -b feature-name

3. Make changes, commit, and push to your branch:

   git add .
   git commit -m "[Your Name][Feature] Description"
   git push origin feature-name

4. Open a pull request to merge your changes into the main repository.

Issues

If you encounter any bugs or have suggestions for improvement, please submit an issue. Your feedback is valuable in enhancing the platform.

Happy hacking! 👾🤖

Contributors

• Ezra Magbanua
• Jhoanna Olana

komshat's Issues

Participants UI

UI for the participants who joined

Should display:

• Team name
• Team members
• Overview
• Demo Video
• Project Image (If they submitted)
• Project Title (Alternative if they haven't submitted)
• Like and Likes

Winner UI per Hackathon

No submission participant UI

UI for participants with no projects

Join Page UI

Own page for joining/registering for a Hackathon

Requirements:

• should only be allowed when there is an active hackathon (Friday 12:00AM to Sunday 11:59:59PM)
• show what hackathon they're joining with appropriate details (title, theme, suggested tech stack)
• team name
• team members

History List Page UI

Page for showing the list of past hackathons

Create Team UI

Captains can create teams

It's basically an option they can select to automatically fill up the details when joining in a hackathon.

Previous Hackathon Page UI

The same with the Home page but for previously held hackathons

Requirements:

• same details with Home page without the buttons
• disable all buttons
• show winner (emphasis)

Change End text in timer

Home UI

Profile Page UI

Profile page

Requirements:

• delete account
• logout

Admin

Edit specific existing hackathon:

• Theme
• Description
• Ideas
• Starting Date - End Date - Submission End Date
• Winning Project
• Project submitted
• Teams participating

Start a hackathon
- Auto generate details
- Input details

Auto generate config
- Auto generate details
- Input details

Function to determine winner automatically