Methodology

Each hackathon project is evaluated across 9 dimensions. Scores are on a 0-10 scale per dimension, then weighted and summed. The final score is normalised to a percentage of the maximum possible.

Dimension	Weight	Description
Code Quality	15%	Readability, structure, naming conventions, complexity, and adherence to best practices.
Documentation	12%	README completeness, inline comments, docstrings, and setup instructions.
Repo Hygiene	8%	Git history quality, .gitignore, no secrets committed, branch hygiene.
Technical Implementation	18%	Architecture design, appropriate use of frameworks, error handling, and performance.
Reproducibility	12%	Can a reviewer clone and run the project? Dependencies, setup scripts, Docker support.
Innovation	15%	Creativity of the solution, novel approaches, use of cutting-edge techniques.
Testing	8%	Unit tests, integration tests, test coverage, and CI configuration.
Security	7%	No hardcoded secrets, input validation, dependency vulnerability scanning.
Presentation	5%	Demo quality, slide deck, video walkthrough, and overall polish.

Score Bands

0 - 3 Needs significant improvement

4 - 6 Meets basic expectations

7 - 8 Good - above average

9 - 10 Excellent - outstanding

Evaluation Pipeline

flowchart LR
  A["Clone Repo"] --> B["Static Analysis"]
  B --> C["Code Quality\nAnalyzer"]
  B --> D["Documentation\nAnalyzer"]
  B --> E["Repo Hygiene\nAnalyzer"]
  B --> F["Tech Impl\nAnalyzer"]
  B --> G["Reproducibility\nAnalyzer"]
  B --> H["Innovation\nAnalyzer"]
  B --> I["Testing\nAnalyzer"]
  B --> J["Security\nAnalyzer"]
  B --> K["Presentation\nAnalyzer"]
  C --> L["Score\nAggregation"]
  D --> L
  E --> L
  F --> L
  G --> L
  H --> L
  I --> L
  J --> L
  K --> L
  L --> M["Weighted\nRanking"]
  M --> N["Report\nGeneration"]
  N --> O["HTML Report"]
  N --> P["Markdown Report"]
  N --> Q["Static Website"]

  style A fill:#6366f1,stroke:#4f46e5,color:#fff
  style B fill:#8b5cf6,stroke:#7c3aed,color:#fff
  style L fill:#a78bfa,stroke:#8b5cf6,color:#fff
  style M fill:#c084fc,stroke:#a855f7,color:#fff
  style N fill:#e879f9,stroke:#d946ef,color:#fff
  style O fill:#22c55e,stroke:#16a34a,color:#fff
  style P fill:#22c55e,stroke:#16a34a,color:#fff
  style Q fill:#22c55e,stroke:#16a34a,color:#fff