RoastLogger

A personal, mobile-responsive web application for home coffee roasters to track beans, log detailed roast profiles, and manage inventory.

Features

• Bean inventory management with stock tracking
• Live roasting interface with real-time temperature monitoring
• K-Type temperature sensor integration (auto-polling, smart averaging)
• Roast profiles with temperature curves and key event markers
• Review system for tasting notes and ratings
• Mobile-responsive design

Quick Start

Prerequisites

• Python 3.11+
• uv package manager
• MongoDB (local or Atlas)

Setup

# Install dependencies
uv sync

# Configure environment
cp .env.example .env
# Edit .env with your MongoDB URI and settings

# Run the app
uv run python app.py

Open http://localhost:5000 in your browser.

Hardware/Firmware

The ESP32 firmware code for the temperature sensor board is located in the thermo/ folder. This is a PlatformIO project that can be built and uploaded to your ESP32 device.

See Hardware Setup for complete setup and usage instructions.

Documentation

For detailed information, see the docs/ folder:

• Project Overview - Start here for navigation and architecture
• Architecture - API endpoints, data models, tech stack
• Features - Detailed feature specifications
• Hardware Setup - K-Type temperature sensor integration
• Deployment - Render deployment guide
• Testing - Running and writing tests