Skip to content
HackWinnerDBv0.1
Community Open Source

Contribute a Winner

HackWinnerDB is an open dataset preserved in git. Every record is stored as validated YAML, every contribution goes through a pull request, and every merge to main automatically redeploys the site.

Three Ways to Contribute

01

No code required

Fill in a GitHub issue form with the hackathon, the project, the award, and a public source link. A maintainer will format and merge it.

Add a hackathon winner
02

Interactive CLI (Fast)

Fork the repo, run npm run add:winner, answer the interactive terminal prompts to generate valid YAML, and open a PR.

Read CONTRIBUTING.md
03

Edit YAML Directly

Power contributors can write hackathon, project, and entry YAML files by hand against our strict Zod schemas.

Read Data Guidelines

What a Good Contribution Looks Like

  • A publicly accessible source link naming the project and the award won.
  • Original description written in your own words — never verbatim marketing copy.
  • Canonical taxonomy slugs for technologies and domain categories.
  • Passing local validation: npm run validate:data and npm run check:duplicates.