Comprehensive documentation, workflows, and best practices for every module in RoastSource.
Craft is the simplest way in — you roast by sight, sound, and smell, and the app keeps notes for you. Pick Craft in the welcome questions (or Settings > Display Mode), then:
RoastSource is a Progressive Web App (PWA) built for home coffee roasters. It works on any device with a browser — phone, tablet, or desktop — and opens even without a connection. On a computer, Chrome or Edge can install it as its own app; in Safari, use Add to Home Screen (iPhone, iPad) or Add to Dock (Mac). RoastSource helps you track your green coffee inventory, log roast sessions with real-time temperature profiling, score your roasts using SCA cupping protocols, explore brewing methods, create custom blends, research equipment, and dive deep into coffee science and origins.
Whether you are roasting your first batch on a popcorn popper or dialing in profiles on a Bullet R1, RoastSource gives you the tools to improve consistently and enjoy the journey.
Track your entire bean collection. Vendor auto-detection recognizes Sweet Maria's, Happy Mug, Bodhi Leaf, and others — bulk import a whole order in one paste. Search, filter, and track freshness across origins, processes, and vendors.
Your roast-day command center. Adaptive profiles tuned to your roaster, roast level, batch size, ambient temperature, and line voltage. Edit or delete saved roasts and browse a date-grouped history. In Journey and Science, every roast earns a 100-point Roast Quality Score, and a live drop window counts down after first crack. Profile import from Artisan (.alog) and CSV is coming soon — imports will live in their own tab so they never mix with your roast log.
Create custom blends and explore 250+ preset blends. Blending Fundamentals teaches post-roast vs. pre-blend roasting. "Your First Blend" walks you through step by step.
Full SCA 100-point cupping protocol with predicted scores, spider charts, and an 8-category flavor intensity wheel. Or skip ahead with a Brief 100-point rating — both feed the same history. Roaster-type weight loss reference compares air, drum, hybrid, and DIY across all 7 roast levels.
Brew calculators and method guides for seven brew methods with ratios, grind size, temperature, and timing. Taste Calibration diagnoses extraction issues. Roast-level adjustments per method.
Roasting Guides for your own machine, 16+ roaster deep dives, and 40+ home roaster models across air, drum, hybrid, and DIY/home-built categories. Fresh Roast ecosystem with the Razzo V5T guide. Temperature probe setup lives in Settings — set it up once and your probe is auto-selected on every roast.
Your coffee education hub. 49 coffee-growing countries on an interactive world map, including the Middle East and Pacific Islands. Practical "Getting There on Your Roaster" guidance, roast troubleshooting, tasting and sensory basics, and the coffee personality quiz.
See your roasting story in one place. Overview, Roast Next, Quality, Ratings, Inventory, Cost, Curves (Science), and Export tabs — with a Data Quality report and print buttons. The Overview and CSV export are free; the rest is part of Home. Craft shows Overview, Roast Next, and Inventory.
Configure your experience. Pick your display mode, set up your roaster and temperature probes, back up your data, and enter your license key. Calibrate probe offsets for accurate readings.
Home roasters don't all roast the same way. RoastSource lets you pick how much you see during a roast and switch any time from Settings. Your beans, history, ratings, and blends stay the same — only the view changes.
“I roast by smell, sight, and sound. I want to enjoy it, not stare at the app.”
You lead with your senses. The app follows. A clean screen that doesn't compete with the roaster, a milestone tap that doesn't break your rhythm, a simple “did I like it?” rating when the cup's ready — and every roast you've ever loved, findable again in one tap.
“I know what I should do. I want to get better at knowing how to do it.”
You know the milestones but want the roadmap between them. Journey mode gives you a suggested path you can learn from, a clear picture of what changed between one roast and the next, and plain-language answers when a number leaves you wondering what it meant.
“I have tried-and-true recipes. Give me every data point and let me run the roast my way.”
You treat every batch as an experiment. Science mode puts every live metric on screen, runs your own recipes prompt by prompt, and gives you real comparisons after the roast — control, not suggestions dressed up as decisions. And soon, it will import what you've built in Artisan.
Every mode includes Inventory, Roasting, Brewing, Java Geek, Reports, Settings, and Help. Blending is the one module Journey adds over Craft. The table below shows where modes differ.
| Module / Feature | Craft | Journey | Science |
|---|---|---|---|
| Quick Roast | ✔︎ | ✔︎ | ✔︎ |
| Quick Roast timer detail | Minimal | Guided + cues | Detailed + DTR |
| Adaptive / Monitor Roast | — | ✔︎ | ✔︎ |
| Roast Quality Score | — | ✔︎ | ✔︎ |
| Roast defect guidance | ✔︎ | ✔︎ | ✔︎ |
| Tasting cards (rest & rate) | ✔︎ | — | — |
| Full SCA cupping | — | ✔︎ Guided | ✔︎ Full |
| Blending | — | ✔︎ | ✔︎ |
| Roasting Equipment | Roasting Guides | ✔︎ | ✔︎ |
| Reports | Overview, Roast Next, Inventory | All tabs but Curves | ✔︎ |
| Import (Artisan .alog & CSV) | Coming soon | ||
| Print view | — | ✔︎ | ✔︎ |
Craft mode users can tap the “Discover more features” card on the main menu to temporarily see Journey and Science features without changing their saved mode.
Adaptive profiles are a starting point, not a requirement. If you've already dialed in a roast that works, RoastSource treats your recipe as the source of truth — enter it, save it, run it, tweak it, and reuse it across every session. You shouldn't have to re-enter years of data just to use the app.
Open Inventory and add your green coffee beans manually or import from a vendor receipt (Sweet Maria's, Happy Mug, Burman, Coffee Shrub, and more).
Go to Settings > My Roasting Equipment and add your roaster with brand, model, batch capacity, and probe info. This enables adaptive profiling.
Open Roasting, select a bean from inventory, and start logging your roast — or import a prior roast (Artisan .alog & CSV — coming soon). Mark first crack and end roast.
After roasting and brewing, use Ratings to cup your coffee with a Brief 100-point score or full SCA protocol. Compare results over time.
RoastSource stores all data locally in your browser by default. This means your data lives on the device you are using — it is not automatically saved to the cloud. If your browser cache is cleared, or you switch devices, your data may be lost unless you have a backup.
On your current computer: Tap Sync in the header to open Sync & Backup (also under Settings > Data & Backup) and choose a local folder to save your RoastSource data (Chrome or Edge). On any browser, Save File downloads a full backup. This creates a backup file you can restore from at any time. We recommend backing up regularly — especially after roast sessions or big inventory changes.
Use your own cloud: On a computer with Chrome or Edge, choose a cloud-synced folder such as Dropbox, Google Drive, or iCloud Drive as your backup location, and the copy leaves your computer too. On iPhone and iPad, use Save File and keep the backup in Files or iCloud Drive.
Help staying backed up: the home menu reminds you when it's been a while since your last backup, Compress backup files makes each file about a tenth of the size, and Settings > Data & Backup > Storage on this device shows how much room your data takes. On iPhone and iPad especially, save a backup file regularly.
Sync is optional, and the backup file is plain data — it isn't encrypted, so keep it somewhere you trust.
⚠️ Important: RoastSource data is stored in your browser's local storage. If you clear your browser data, use private/incognito mode, or reset your device, your data will be lost. Always keep a backup — a synced folder or a saved backup file. Backing up takes seconds and protects hours of roasting logs, ratings, and inventory.
Detailed documentation for every RoastSource module. Each guide covers all views, workflows, tips, and best practices.
Full reference: adding beans, importing receipts, searching and filtering, exporting, tracking freshness, purchase history, wishlists, and syncing.
Full guide →Full reference: Quick Roast, Adaptive profiles, Roast Quality Scores, defect guidance, date-grouped history, profile import (coming soon), and how the module adapts across Craft, Journey, and Science modes.
Full guide →Full reference: creating blends, exploring 250+ presets, world blends, personality-based blends, and blend management. Available in Journey and Science modes.
Full guide →Full reference: simplified Tasting cards (Craft), Brief 100-point ratings, the SCA 100-point cupping form, predicted scores, spider charts, and how the module adapts across modes.
Full guide →Full reference: all seven brew methods with brew calculators and a step-by-step brew timer, freshness and grinding guides, grinder recommendations, and the taste-troubleshooter for under- and over-extraction.
Full guide →Full reference: Roasting Guides, Equipment Advisor, 16+ roaster deep dives, 40+ home roaster models, DIY/home-built category, and popcorn poppers. Craft shows the Roasting Guides; Journey and Science show the full module.
Full guide →Full reference: all nine tabs — 49 coffee-growing countries on an interactive world map, bean varieties, processing, grades, growing seasons, roast science, roast levels, tasting & sensory, and the personality quiz.
Full guide →Full reference: Overview, Roast Next, Quality, Ratings, Inventory, Cost, Curves, and Export tabs, which tabs each mode shows, the Data Quality report, and printing your reports.
Full guide →Full reference: choosing your display mode, adding your roaster, temperature probe setup & calibration, Sync & Backup, your license key, and themes.
Full guide →You do not need to leave RoastSource to get help. Interactive help is available on every screen.
Every module has a Help button in its header. Tap it to see quick start tips, key workflows, and useful hints for the current screen.
Look for small info icons next to complex features like Rate of Rise, SCA scoring, and equipment specs. Hover or tap for a quick explanation.
Each in-app help panel links to a full reference guide here in the Help Center with detailed walkthroughs, best practices, and tier availability tables.
Can't find what you're looking for? Ask the community. Other roasters and the developer are active in the forum and happy to help.
Post your question and get help from the community and the developer.
Found something broken? Report it so we can fix it fast.
Have an idea? Suggest it and vote on what gets built next.