Indian Coffee Beans (ICB)

An independent, open-source directory for India's specialty coffee ecosystem.

Live website · Contribute · Security · License

ICB helps coffee drinkers discover Indian roasters and coffees, understand origin and processing, compare available options, and share community ratings. It is a directory and discovery resource, not a coffee marketplace. The code behind the site is public and MIT-licensed.

Status and impact

Live in production; actively maintained. As of November 2026, the live website serves approximately 10,000 unique visitors over 90 days and has around 100 registered users. Its directory covers 100+ Indian specialty coffee roasters and 1,500+ coffees. These are approximate website and catalog figures, not GitHub downloads, forks, or third-party deployments.

Catalog coverage changes as coffees appear or are discontinued. The purpose of opening the code is to make the implementation inspectable and to welcome contributions to discovery, accessibility, content presentation, tooling, and maintenance.

Features

• Coffee discovery: browse and filter coffees by roaster, origin, process, roast, tasting notes, and other attributes.
• Roaster directory: independent profiles and links to roasters' own websites.
• Community participation: accounts, preferences, and coffee ratings.
• Coffee tools and education: interactive brewing utilities, coffee-region information, and learning content.
• Search and sharing: searchable listings, shareable filtered URLs, and search-friendly pages.
• Developer-facing functionality: API routes and related infrastructure for integrations.

The production catalog and editorial content depend on external services and are not bundled as a redistributable dataset with this repository.

Technology

• Next.js 16 (App Router), React 19, TypeScript
• Tailwind CSS v4, Radix UI/shadcn/ui, Motion
• Supabase (PostgreSQL, authentication and row-level security)
• Sanity for editorial content; ImageKit for media
• Upstash Redis for API rate limiting; PostHog for product analytics

See package.json for the current versions and available scripts. Source code is the reference if an older design document differs from the implementation.

Local development

Requirements

• Node.js 22.12.0 or newer, npm 10.8.2 or newer
• Your own Supabase project for local development
• Optional third-party accounts for features backed by Sanity, ImageKit, Redis, and other integrations

Start

git clone https://github.com/3lokai/icb-v2.git
cd icb-v2
npm ci
cp .env.local.example .env.local
# Replace example values with your own development credentials.
npm run dev

Open http://localhost:3000.

Important: Do not use production credentials or a production database for local development. Review the environment example and env.ts, and supply the services relevant to the feature you are working on. A fresh database may not include the coffee catalog, editorial material, images, or other data used by the live site. As a result, some pages and integrations may not function in a standalone local install.

If your change requires database schema work, inspect supabase/migrations first and only apply migrations to a local or disposable development project. Do not run migrations against the live database.

Quality checks

npm run type-check
npm run lint
npm run test
npm run format:check

Production builds may require additional environment variables and access to configured services. See the scripts in package.json. In a pull request, say which checks you ran and which you could not run.

Repository map

Path	Purpose
src/app	Next.js routes, APIs, and server actions
src/components	Feature and shared UI components
src/lib	Data access, business logic, utilities, and integrations
src/hooks	React hooks
src/types	Domain and generated database types
supabase	Database migrations and Supabase functions/configuration
docs	Technical documentation and architecture decisions
scripts	Maintenance and data-operation scripts

Contributing and maintenance

Bug reports, documentation fixes, accessibility improvements, focused tests, and proposals to make coffee discovery better are welcome. Please read CONTRIBUTING.md before opening a pull request, and follow our Code of Conduct. Security concerns should be reported privately using SECURITY.md, not as public issues.

This is a small, independently maintained project. The main branch reflects production development; the dev branch is also used for ongoing work. Check the contribution guidelines and existing pull requests before choosing a target branch.

Licensing and data

The source code is available under the MIT License. That does not automatically license third-party coffee descriptions, photographs, roaster names/logos, editorial assets, or external datasets for redistribution. Verify the applicable rights before republishing non-code material.

---

Built for the Indian specialty coffee community. Explore the live site.