Contribute
HackWinnerDB is a community-maintained open dataset. GitHub is the source of truth: every record lives in a YAML file, every change goes through a pull request, and every merge to main redeploys the site.
1. No code required
Fill in a GitHub issue form with the hackathon, the project, the award, and a public source. A maintainer converts it into data.
Add a hackathon winner ↗2. Guided pull request
Fork the repository, run npm run add:winner, answer the prompts, and the CLI writes the YAML files for you. Then run validation and open a PR.
Read CONTRIBUTING.md ↗3. Edit the YAML directly
Advanced contributors can write hackathon, project, and entry files by hand against the documented Zod schemas.
Read the data guidelines ↗What a good contribution looks like
- A public source that names the project and the award it won.
- Descriptions written in your own words — never pasted from the original page.
- Canonical technology and category slugs from the taxonomy files.
- Validation passing locally:
npm run validate:dataandnpm run check:duplicates.