BeanFlow — SaaS for Coffee Roasters & Cafes

About this project
Overview
BeanFlow is a production-grade SaaS platform that gives specialty coffee roasters and cafés one precise dashboard for everything between green coffee and the cup — green inventory, roast logs, drink COGS, wholesale invoicing, retail bag sales, and multi-location stock transfers.
Built ground-up over multiple beta-feedback rounds with real roasters (Tony N., Micah, David at Zaca Coffee), every feature ships only after the user requesting it has signed off on it live.
🔗 Live: beanflow.io
The Problem
Most roasters track inventory in spreadsheets and COGS in their head. They lose money to invisible shrink, mispriced wholesale bags, and packaging cost mistakes. Existing tools are either too generic (QuickBooks) or too narrow (Roastime).
The Solution
A two-mode SaaS — Roaster and Cafe — that automates the inventory-to-COGS pipeline:
Roaster Mode

Green Profiles with auto-calculated landed cost (base + freight + customs per lb)
Roast Log — Single Batch OR Blend Batch (up to 3 green coffees with % sliders), auto-deducts green inventory, computes per-lb cost
Roast Groups — combine multiple separate roasts under one shared packaging cost
Packaging-aware roasted inventory — tracks loose vs bagged stock per bag size for accurate sales
Wholesale Sales Orders with QuickBooks sync + auto-email invoicing
Multi-location transfers — move roasted stock to specific cafe locations

Cafe Mode

Recipes with multi-size pricing (3oz → 30oz variants)
Daily Sales Log with Square POS CSV import
Modifier-aware deduction — oat milk swaps re-route from oat inventory, extra shots add bean usage
Sales Summary with week/month / all-time rollups, latest-day fallback
Live drink COGS with retail bag sales tracking

Shared
Per-card "Manage" pills route directly to edit modals — one click to full details
Real-time Firestore sync across devices
Custom QuickBooks + Shopify integrations
Stripe-ready payment plan toggle (Roaster Pro / Cafe Pro / Multi-Location)
WebAuthn passkey login for password-less access
Admin panel for user management + chat oversight

Engineering Highlights
17+ pages, deeply mode-aware (Roaster vs Cafe surfaces different navigation, recipes, and stats)
34/34 unit tests passing — pure calculation logic for COGS, roast loss, blend cost math, bag-size parsing
TypeScript-strict end-to-end — zero
anyleakage in business logicFirestore security rules for multi-tenant data isolation with location-scoped access
Cloud Functions for OAuth callbacks (QuickBooks, Shopify, Square), invoice email delivery, and scheduled reorder PO sender
CI/CD via Firebase Hosting with named Firestore database
My Role
End-to-end ownership — product discovery, architecture, full-stack implementation, integration wiring, deployment, and iterative shipping against real-user beta feedback rounds. Live on production at beanflow.io.