This is an open-source hackathon toolkit designed for institutional adaptation. Contributions — new problems, template improvements, and reports from institutions that used the toolkit — improve it for everyone.
Propose additions to the problem bank by opening an issue using the new problem template. Each problem must follow the 7-component structure:
- Problem statement — with supporting data or statistics
- Affected stakeholders — who is impacted
- Current inadequate solutions — what's been tried and why it falls short
- Regional context — local data grounding the problem
- Global context — universal framing of the challenge
- Ethical considerations — aligned with the Principled Innovation framework
- Prototype scope — what a team can build in 2.5 days
Found an error, broken link, or unclear section in the templates? Open a PR with the fix. For larger structural changes, open an issue first to discuss.
Ran a hackathon using this toolkit? We want to hear about it. Open an issue using the adaptation report template to share what you kept, what you changed, and what you learned.
- Branch naming:
content/<description>,fix/<description>, oradaptation/<description> - Commit messages: Imperative mood, concise (e.g., "Add problem 51: rural pharmacy access")
- Scope: One logical change per PR
This project uses Semantic Versioning:
- MAJOR — Breaking changes to template structure (renamed placeholders, restructured evaluation criteria, changed problem format)
- MINOR — New content (problems added, new templates, new resource guides)
- PATCH — Typo fixes, data corrections, clarifications, link fixes
This project follows the Contributor Covenant v2.1. Be respectful, inclusive, and constructive.