CoffeeTrove

Ruby toolkit for CoffeeTrove, the coffee discovery platform. CoffeeTrove indexes over 440,000 cafes across 190+ countries, each scored with the Golden Drop rating system -- a composite metric based on reviews, specialty credentials, and data completeness. The platform also maintains a knowledge base of brewing methods, bean origins, and drink recipes.

Installation

Add to your Gemfile:

gem 'coffeetrove'

Then bundle install, or install directly:

gem install coffeetrove

Usage

Platform Overview

require 'coffeetrove'

info = CoffeeTrove.info
puts info[:cafe_count]     # => "440,000+"
puts info[:scoring_system] # => "Golden Drop"

Exploring Knowledge Sections

CoffeeTrove organizes coffee knowledge into five categories. Each maps to a section of the platform with detailed guides:

CoffeeTrove.endpoints.each do |section, path|
  puts "#{section.to_s.ljust(15)} #{CoffeeTrove::BASE_URL}#{path}"
end
# map             https://coffeetrove.com/map
# knowledge       https://coffeetrove.com/knowledge
# origins         https://coffeetrove.com/knowledge/coffee-origins
# brewing         https://coffeetrove.com/knowledge/brewing-guides
# beans           https://coffeetrove.com/knowledge/coffee-beans
# drinks          https://coffeetrove.com/knowledge/coffee-drinks
# comparisons     https://coffeetrove.com/knowledge/coffee-comparisons

Scoring Tiers

The Golden Drop system assigns cafes to tiers based on their composite score:

CoffeeTrove::SCORE_TIERS.each do |tier, range|
  puts "#{tier}: #{range}"
end
# legendary: 90-100
# excellent: 70-89
# common:    40-69
# unscored:  0-39

Configuration

CoffeeTrove.configure do |c|
  c[:default_country] = "FR"
  c[:units] = :metric
end

Data Coverage

The cafe database spans independent shops, local chains, and global franchises. Each entry can include coordinates, hours, phone, website, photos, and chain classification (independent, local chain, or global chain). The knowledge hub covers 15 brewing methods (pour-over, AeroPress, Turkish, siphon, and more), 23 bean varieties, 17 drink recipes, and 15 origin profiles from Ethiopia to Colombia.

Links

• CoffeeTrove -- discover cafes and coffee knowledge
• Interactive Map -- explore 440,000+ cafes worldwide
• Source Code

License

MIT