Skip to content

COS301-SE-2026/Hackathon-Platform

Repository files navigation

Hackathon Platform - Keyboard Gremlins

Logo

A cloud-agnostic, full-stack event management platform that is pupose-build for deterministic optimization challenges. This platform automates the entire hackathons lifecycle, from highly configurable event setups, particpant registaritons and team formation to execution. Submission are dynamically queued and processed by a scalable pool of parallel scoring workers, this allows the official grading solver to evaluate, score and log outputs in ral-time to drive dynamic live leaderboards. Engineered with a modular Spring Boot backend and a desktop-first, mobile-friendly Angular frontend. The system also supports dymanic runtime solver updates by the event orgranisers and scales scales such that it can handle peak submission spikes near competition deadlines.

Badges

CI

Lighthouse CI

GitHub Issues

GitHub Requirements

GitHub Project Board: View the Project Board

Documentation


Team Members

Ayush Sanjith

Team Lead, Backend Developer, DevOps

LinkedIn: Ayush Sanjith

Heinrich Römer

Backend Developer, System Integration, Database

LinkedIn: Heinrich Römer

Kwaku Asiedu

Full-stack developer, System Integration

LinkedIn: Kwaku Asiedu

Rene Reddy

UI/UX Engineer, System Integration

LinkedIn: Rene Reddy

Jasveer Ramdhaw

Full-stack developer, Database

LinkedIn: Jasveer Ramdhaw

How to Run

Prerequisites

Make sure you have the following:

  • Java 21
  • Maven
  • Node.js 20+
  • npm
  • PostgreSQL
  • Angular CLI

Backend

Navigate to backend folder:

cd backend
Run the Spring Boot application:

mvn spring-boot:run

run tests and build the project:

mvn clean verify

Frontend

Navigate to frontend folder:

cd frontend

Install dependencies:

npm install

Run the Angular server:

npm start

The frontend should be at:

http://localhost:4200

Running Tests

Backend Tests

cd backend
mvn test

Frontend Tests

cd frontend
npm test

Frontend Linting

cd frontend
npm run lint

Git strategy

GitFlow was chosen as the git strategy. main is the default branch and contains production ready code, dev contains the latest code in development.

About

A cloud-agnostic Hackathon Platform for deterministic optimization challenges where participants submit solutions that are automatically scored by a solver. It supports event management, team collaboration, real-time leaderboards, and scalable submission processing for large-scale competitive programming-style hackathons.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors