Version history
See what changed in each RoastBook release.
RoastBook - Version History
A comprehensive coffee roasting log application for roaster teams with quality control, inventory management, and collaborative features.
v2.7.0 - Referral Codes (February 23, 2026)
Referral Codes
- Claim free subscription: Organization owners can enter a referral code on the Organization page to claim a free subscription (no payment required)
- Create & manage codes: Superadmins can create referral codes with configurable benefits (e.g. Pro plan for 1 month), optional max redemptions, and expiry date
- Auto-generate or custom: Codes can be auto-generated or set manually
- One per org: Each organization can redeem a given code at most once; redemptions are tracked for reporting
v2.6.0 - AI Roast Analysis Intelligence Upgrade (February 12, 2026)
🤖 AI Analysis Enhancements
-
Bean-Specific Insights (NEW)
- Comprehensive defect probability analysis based on bean density, moisture, and processing
- Origin-specific flavor forecasts tailored to bean provenance (e.g., Ethiopian floral/citrus, Colombian caramel/chocolate)
- Variety-specific roasting recommendations for Gesha, Bourbon, Typica, Caturra, and other cultivars
- Process-guided adjustments for Natural, Washed, Honey, and Anaerobic processing methods
- Research-backed citations and roasting papers integrated into analysis
-
Roast Performance Forecast (NEW)
- Real-time comparison of current roast execution against bean-specific ideal parameters
- Phase-by-phase assessment (Drying, Maillard, Development) with targeted feedback
- Research-backed Development Time Ratio (DTR) ranges:
- Filter Coffee: 15-22% optimal (ideal: 17-20%) - Scott Rao research
- Espresso: 20-25% optimal (ideal: 22-24%) - Standard espresso guidelines
- Omniroast: 18-24% optimal (ideal: 20-22%) - Balanced profile research
- Expected cup profile forecasting based on actual roast curve execution
- Defect likelihood prediction combining bean vulnerabilities with roast curve analysis
- Quality outlook assessment with confidence levels
-
Enhanced AI Prompt System
- Added comprehensive roasting phase guidelines (Drying: 30-50%, Maillard: 30-45%)
- Integrated bean metadata (varieties, MASL altitude, moisture content, bean type)
- Cross-referenced development time with expected flavor characteristics
- Intelligent "next roast adjustments" that incorporate all bean-specific insights
- Increased token limit to 3500 for comprehensive analysis output
🎨 User Interface Improvements
-
Bean Insights Section
- Full-width section positioned below phase balance for optimal visibility
- 2-column responsive layout (lg:grid-cols-2) for desktop organization
- Color-coded subsections for visual clarity:
- Emerald theme for main bean insights
- Amber theme for defect probability warnings
- Blue theme for origin-specific forecasts
- Purple theme for variety recommendations
- Teal theme for process guidance
- Indigo theme for roast performance forecast
- Collapsible sections to reduce visual clutter
- 3-column grid for Phase Assessment, Expected Cup Profile, and Defect Forecast
-
Landing Page Updates
- Added bean-specific insights preview cards
- Showcased Origin Forecast, Defect Risk, and Variety Guidance examples
- Enhanced AI Analysis feature spotlight section
- Demonstrated research-backed analysis capabilities
✅ Technical Improvements
-
Backward Compatibility
- All new fields use optional TypeScript types with safe conditional rendering
- Existing roasts without enhanced analysis display correctly
- Graceful degradation for partial data availability
- Optional chaining throughout UI components
-
Type Safety & Schema
- Enhanced StructuredRoastInput with varieties, MASL, moisture, bean_type, origin_country
- Comprehensive JSON schema for AI response validation
- TypeScript interfaces for roast_performance_forecast with assessment enums
- Proper defect type mappings and likelihood indicators
🔧 Bug Fixes
- DTR Assessment Accuracy
- Fixed incorrect "too_short" assessment for 13% development time (now correctly flags as insufficient for all roast types)
- Aligned assessment thresholds with specialty coffee research and industry standards
- Corrected filter coffee development range (was incorrectly allowing <15%)
v2.5.4 - Invoices Spotlight & Version Card Refresh (February 10, 2026)
✅ Improvements
- Landing Page Invoices Spotlight
- Added a dedicated invoices feature section to the landing page
- Highlighted PDF exports, branding, and payment-ready summaries
- Version Control Card Update
- Refined the landing page version card with clearer release messaging
v2.5.3 - Bulk Import & Landing Update (February 10, 2026)
✅ Improvements
- Bulk Roast Import
- Added a bulk import workflow for multiple roast files in one upload
- Streamlined validation, selection, and save feedback for batch imports
- Landing Page Update
- Highlighted bulk import capabilities in the feature overview
v2.5.2 - Release Notes Visibility & Loading States (February 4, 2026)
✅ Improvements
- Public Version History Page
- Added a public, readable release notes page for customers
- Linked from the marketing site for quick access
- Dashboard Version Label
- Shows the current version directly under the RoastBook logo in the sidebar
- Roast Plan Loading State
- Added table-level loading skeleton while roast plans load
v2.5.1 - Auth Reliability & Documentation Refresh (February 3, 2026)
✅ Improvements
- Google OAuth Flow Fix
- Prevented OAuth callbacks from being misrouted to password reset
- Added recovery-type guard before redirecting to reset password
📚 Documentation
- Refreshed project README with updated setup, auth, and deployment notes
v2.5.0 - Quality Control & User Experience Enhancement (January 14, 2026)
🆕 Major Features
- Professional Quality Control System
- SCA (Specialty Coffee Association) cupping protocols implementation
- CVA (Coffee Value Assessment) descriptive and affective methods
- Internal QC evaluations for team quality control
- Public cupping forms with QR code sharing for transparency
- Comprehensive scoring with detailed flavor descriptors and notes
- Enhanced QC list UI with improved filtering options
🎨 User Experience Improvements
- Toast Notification System
- Integrated react-toastify for professional notifications
- Replaced all alert() dialogs with contextual toast messages
- Enhanced user feedback across QC workflows
- Landing Page Enhancement
- Added dedicated QC feature spotlight section
- Highlighted SCA/CVA protocols and public QR sharing capabilities
- Professional evaluation preview with realistic scoring examples
🐛 Bug Fixes
- Fixed TypeScript compilation errors for production builds
- Improved UI consistency across QC components
- Enhanced responsive layout for new QC page
v2.4.0 - Payment Integration & Subscription Management (December 2025)
🆕 Major Features
- Payment System Integration
- Midtrans payment gateway implementation
- Subscription plan management with database-driven plans
- Automated webhook handling for payment notifications
- Subscription expiry tracking and enforcement
💳 Subscription Features
- Seat limit enforcement for team invitations
- Upgrade/downgrade workflow with mailto integration
- Real-time subscription status checking
- Payment success/failure handling
🔧 Infrastructure
- Staging branch workflow for payment testing
- Enhanced webhook security with test notification support
- Ngrok support for local payment testing
v2.3.0 - Sharing & Analytics Platform (November 2025)
🌐 Sharing System
- Short-Share Links
- Secure share token generation for roast data
- Public roast viewing without authentication
- Custom metadata for shared content
- Delete/manage existing share links
📊 Analytics Integration
- PostHog analytics implementation
- User behavior tracking on login/register pages
- Performance monitoring and user insights
- Privacy-compliant analytics setup
🎨 User Interface
- Enhanced share page styling with outlined CTAs
- Improved metadata handling for social sharing
- Client-side time formatting for shared roasts
- Event times displayed relative to CHARGE event
v2.2.0 - Advanced Roasting Features & UI Overhaul (October 2025)
📈 Roast Chart Enhancements
- Advanced Chart Features
- BBP (Bean Batch Profile) toggle functionality
- Timeline rebase for better event correlation
- Interactive legend with hide/show capabilities
- Mobile-optimized chart interface
- Statistics panel with comprehensive roast metrics
- Enhanced tooltip information and Y-axis scaling
🔥 Roasting Process Improvements
- Agtron color measurement integration
- Moisture content tracking for roast plans and results
- Phase detail precision (decimals to 1 place)
- Event-based ticker system for real-time chart updates
- Burner and special-event plotting enhancements
📱 Mobile & Responsive Design
- Complete mobile cards layout for roasts
- Responsive drawer animations for roast plans
- Animated mobile sidebar with backdrop
- Mobile-optimized bean inventory layout
- Touch-friendly interface improvements
v2.1.0 - Team Collaboration & Inventory Management (September 2025)
👥 Team Features
- Organization Management
- Team invitation system with role-based access
- Profile and organization sidebar improvements
- Assignee tracking for roast plan schedules
- Seat limit management for subscription plans
📦 Inventory System
- Green Bean Warehouse
- Comprehensive inventory transaction logging
- Bean status tracking with visual indicators
- Stock level monitoring with low-stock alerts
- Metadata management for green bean varieties
- Weight tracking in kg with percentage loss calculations
🗓️ Planning & Scheduling
- Roast Plan Management
- Production schedule creation and tracking
- Team assignment for planned roasts
- Batch size and date coordination
- Status tracking from draft to completion
- Weight excess warnings and validation
v2.0.0 - SaaS Platform Foundation (August 2025)
🏗️ Architecture Redesign
- Full SaaS Implementation
- Multi-tenant organization structure
- Row Level Security (RLS) implementation
- Scalable subscription model
- Production-ready authentication system
🔐 Authentication & Security
- Enhanced Auth System
- Supabase authentication integration
- Forgot password functionality with email notifications
- Registration confirmation workflow
- Password reset with secure token handling
- Production email redirect fallbacks
🎨 Brand & Design System
- Professional UI Overhaul
- RoastBookLogo with Beta badge implementation
- Consistent design language across platform
- SEO metadata and favicon system
- Accessibility improvements (removed visible menu labels)
- Loading transitions and smooth page navigation
📊 Dashboard & Statistics
- Main dashboard with key metrics
- Statistics page with comprehensive roasting insights
- Performance tracking and trend analysis
- Team productivity monitoring
v1.0.0 - Initial Release (July 2025)
🚀 Core Features
- Roast Chart Visualization
- .alog file upload and parsing
- BT (Bean Temperature), ET (Environment Temperature), and RoR (Rate of Rise) plotting
- Event markers for key roasting milestones
- Interactive chart with zoom and pan capabilities
📝 Roast Logging
- Basic roast data entry and management
- Event tracking during roast process
- Notes and observations recording
- Historical roast data storage
🌱 Foundation
- Next.js application framework
- Supabase backend integration
- Basic user authentication
- Responsive design principles
Development Stack
Frontend
- Next.js 16.1.0 - React framework with Turbopack
- React 19.2.3 - UI library with TypeScript
- Tailwind CSS - Utility-first CSS framework
- Recharts & D3-Scale - Chart visualization
- React-Toastify - Notification system
Backend & Database
- Supabase - Backend-as-a-Service
- PostgreSQL - Database with Row Level Security
- Server-Side Rendering - Optimized performance
Integrations
- Midtrans - Payment gateway
- PostHog - Analytics platform
- Email Services - Transactional emails
Contributing
This project follows semantic versioning and maintains detailed commit history for transparency and maintainability. Each release includes comprehensive testing and quality assurance.
For questions or contributions, please refer to the project repository and documentation.
Last updated: February 23, 2026 Project maintained by the RoastBook development team