$ cd ~/projects Roastbook A coffee journal with an open data ecosystem ──────────────────────────────────────────────────── A coffee journal for brews, beans, recipes, cafe visits, and gear, available self-hosted or as a hosted service. The ecosystem includes Open Coffee Data, a public dataset of coffee places, and Open Coffee Schema, an open standard for coffee data. tags: TypeScript, Web Development, PostgreSQL, PWA ──────────────────────────────────────────────────── The Roastbook journal overview, shown with sample data. screenshot https://lohr.dev/images/projects/roastbook-overview.png ──────────────────────────────────────────────────── ## A journal for your coffee Roastbook connects the coffee you buy with how you brew it and how it tastes. A coffee can have several bags, each with its own roast date, weight, price, and shop. Brew history stays attached to the coffee across repeat purchases. Recipes provide a starting point for the next brew. Log dose, yield, and time for a quick entry, or record more detail about grind, temperature, pressure, and equipment. Ratings, flavor notes, and parameter charts help you compare the results and track how changes in beans, recipes, and gear affect the cup. Café visits and equipment belong in the same journal. Use Roastbook in the browser or install it as a PWA. The installed app keeps the journal on your device, works offline, and synchronizes changes when you reconnect. Roastbook website https://roastbook.coffee/ Roastbook on GitHub https://github.com/michidk/roastbook ──────────────────────────────────────────────────── ## Optional AI and integrations Optional AI tools read coffee labels from photos, research beans and equipment, and suggest brewing adjustments based on earlier brews. Suggested values are validated and reviewed before saving. The journal also works without AI. A REST API and MCP interface let scripts and agents read and update the journal. Access is scoped by resource and permission, so an integration can receive only the access it needs. API keys and MCP tokens have per-resource read and write permissions. Roastbook on GitHub https://github.com/michidk/roastbook ──────────────────────────────────────────────────── ## Roastbook Cloud The cloud version is the managed way to use Roastbook. Open the hosted app to keep your coffee journal without deploying the application or operating your own database and storage. To try the journal first, use the editable demo. It runs entirely in your browser with sample data and needs no account. Changes stay in that browser. Open Roastbook Cloud https://app.roastbook.coffee Try the demo https://demo.roastbook.coffee/overview Roastbook website https://roastbook.coffee/ ──────────────────────────────────────────────────── ## Self-hosted Roastbook The public, open-source version runs on your own infrastructure. Docker Compose provides a setup for a home server, and a Helm chart supports Kubernetes deployments. You operate the application with your own PostgreSQL database and local or S3-compatible media storage. Use private accounts with email codes and passkeys, or run one shared journal behind your own authentication proxy. The repository includes the source code, deployment instructions, and configuration for connecting an optional OpenAI-compatible AI provider. Roastbook on GitHub https://github.com/michidk/roastbook Self-hosting guide https://github.com/michidk/roastbook/blob/main/docs/deployment.md ──────────────────────────────────────────────────── ## Open Coffee Data Open Coffee Data publishes records of coffee places, starting with Munich. They describe opening hours, available brew methods, and other practical details, including when each record was checked. The explorer provides a map, a searchable table, and [downloadable data](https://data.roastbook.coffee/downloads/). The dataset is published under CDLA-Permissive-2.0 for reuse in other applications. Its repository contains the records and contribution instructions. Open Coffee Data website https://data.roastbook.coffee/ Open Coffee Data on GitHub https://github.com/Roastbook/open-coffee-data ──────────────────────────────────────────────────── ## Open Coffee Schema Open Coffee Schema defines the structure of coffee-place records and related data, including equipment, brew methods, and pour patterns. It provides versioned JSON Schemas, generated TypeScript types, and a field explorer with a [validation playground](https://schema.roastbook.coffee/playground/). Other applications can use the data and schema independently of Roastbook. Its repository contains the schemas, tooling, and explorer source. Open Coffee Schema website https://schema.roastbook.coffee/ Open Coffee Schema on GitHub https://github.com/Roastbook/open-coffee-schema ──────────────────────────────────────────────────── $ ls ~/pages > about curl -L lohr.dev > projects curl -L lohr.dev/projects > blog curl -L lohr.dev/blog > stats curl -L lohr.dev/stats > contact curl -L lohr.dev/contact ──────────────────────────────────────────────────── https://lohr.dev