One-sentence pitch: what it does and for whom.
Hackathon: <name + link> · Track(s): <tracks / sponsor bounties> · Team: <names / handles> Demo video: <link (2–5 min)> · Live demo: · Tracker issue: <Blockchains/hackathons#N>
What hurts today, for whom, and why existing options fall short.
What we built. Screenshot or diagram in docs/.
- Architecture: frontend / backend / contracts / agents
- Chains & contracts: network, addresses, verified source links
- Sponsor tech used (and exactly where in the code)
List what is new vs. pre-existing (many hackathons require this).
git clone <repo>
cd <repo>
# install + run stepsCopy .env.example to .env and fill in values — never commit .env or keys.
For AI agents and builders: read
AGENTS.md(setup, commands, structure, rules),llms.txt(doc map) and the machine-readableblocks.json(schema). How all Blockchains blocks fit together: Build with Blocks · org catalogue: https://blockchains.github.io/blocks.json.
What it exports
| Export | Type | Install / access |
|---|---|---|
Use this template |
git | GitHub template |
.github/workflows/ci.yml |
file | gitleaks + auto-detected build/test (package.json, requirements.txt/pyproject.toml, foundry.toml) |
Minimal example
gh repo create my-entry --template Blockchains/hackathon-entry-template --public --clone
cd my-entry && cp .env.example .env # never commit .envInputs → outputs
- In:
your code(src/) - Out:
entry repo with CI(repo)
Composes with
- Blockchains/hackathons: link the tracker issue in the README header
- Blockchains/blockchainlab-starters: start the code from a starter
- Blockchains/grokhack-submissions: Grok Hack specific template
Versioning & stability: stable. Template; changes affect new entries only.
MIT — see LICENSE.
Created from Blockchains/hackathon-entry-template. Submission checklist: docs/SUBMISSION.md.