Join

hoppyfrood is built in the open — everything happens on Codeberg, and every part of the ecosystem is specified in the spec repository.

For breweries

Your beers belong in the codex, and you know them best.

• Add your brewery and beers directly: the codex is a git repository — add a folder with a JSON file and open a pull request. The contributing guide walks through it.
• Self-publish a feed: host a single JSON document with your brewery info and full beer catalog, following the brewery feed spec, and the codex can update itself from it.

For shops

The codex gives you permanent, vendor-neutral ids for beers, breweries, and styles — plus barcodes where known.

• Consume the flat indexes directly, no API key, no scraping: https://codeberg.org/hoppyfrood/codex/raw/branch/main/index/beers.json
• Reference beers by codex id (e.g. nl/brouwerij-t-ij/ipa) in your own systems and stay compatible with the whole ecosystem.
• Missing a beer you stock? Add it — see the brewery section above; the process is the same.

For beer lovers

• Improve the data: spotted a missing beer or a wrong ABV? The codex takes pull requests from anyone — contributing guide.
• Checkins are coming: the server spec defines independent servers where you keep your account and beer checkins — your data, portable, federated. Watch the servers page.