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.

Add to your Gemfile:

gem 'coffeetrove'

Then bundle install, or install directly:

gem install coffeetrove

require 'coffeetrove'

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

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

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

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

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.

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

MIT