GrindLab is an iOS/macOS application built with SwiftUI that analyzes coffee grind consistency using computer vision. The app uses the device camera to capture images of coffee grounds and provides detailed analysis including particle size distribution, uniformity metrics, and brewing recommendations.
Grind size has the largest impact on extraction quality, but measuring it consistently has always been a challenge. Most of us eyeball it or rely on grinder settings that can vary from day to day. GrindLab aims to change that by turning your iPhone's camera into a precise measurement tool, giving you the data you need to dial in the perfect cup.
- Real-time camera capture with Vision framework processing
- Particle detection and size distribution analysis
- Coin calibration for accurate physical measurements (μm scale)
- Support for multiple grind types: Filter, Espresso, French Press, Cold Brew
- Particle size distribution histograms
- Uniformity coefficient and statistical analysis
- Median, mean, and standard deviation calculations
- Fines and boulders percentage tracking
- Grind type-specific target ranges:
- Filter/Pour-Over: 400-800μm
- Espresso: 170-300μm
- French Press: 750-1000μm
- Cold Brew: 800-1200μm
- Personalized adjustment suggestions based on analysis results
- Extraction quality indicators
- Log flavor profiles alongside grind analysis
- Track brewing parameters and results over time
- Compare analyses to dial in consistency
- Export and share your data
- Built-in timer with haptic feedback for precise brewing control
- Pre-loaded recipes for various brewing methods
- Step-by-step brewing guides with timing instructions
- Custom recipe creation and management
- Real-time timer updates on your Lock Screen and Dynamic Island
- Track brewing progress without opening the app
- At-a-glance time remaining and current brew step
- Seamless iOS integration for the perfect brewing experience
- iOS 26.0+
- Xcode 26.0+
- Clone the repository:
git clone https://github.com/yourusername/GrindLab.git
cd GrindLab- Open in Xcode:
open "Coffee Grind Analyzer.xcodeproj"- Build and run on your device or simulator
- Select Grind Type: Choose your brewing method to set appropriate target ranges
- Capture Image: Place coffee grounds on a white background, optionally with a coin for calibration
- Analyze: Let the Vision framework detect and measure particles
- Review Results: View distribution graphs, uniformity metrics, and recommendations
- Log Notes: Add tasting notes and brewing parameters for future reference
- SwiftUI: Modern declarative UI framework
- Vision Framework: Apple's computer vision for particle detection
- AVFoundation: Camera capture and management
- Core Image: Advanced image preprocessing
Coffee Grind Analyzer/
├── Analysis/ # Image processing and analysis engine
├── Camera/ # Camera capture and preview
├── Models/ # Data models and persistence
├── Services/ # Business logic and service layer
├── ViewModels/ # View models for MVVM architecture
├── Views/ # SwiftUI views and components
│ └── BrewTab/ # Timer, recipes, and brewing features
└── Assets.xcassets/ # Icons and resources
We welcome contributions! Please feel free to submit pull requests or open issues for:
- Bug fixes
- New features
- Performance improvements
- Documentation updates
This project is licensed under the MIT License - see the LICENSE file for details.
- Coffee science community for grind size research
- Apple Vision framework documentation
- SwiftUI developer community
Built with ☕ and Swift by coffee enthusiasts, for coffee enthusiasts