CroptoDigital Ecosystem for Makhana Industry

Connect, grow and thrive with India's most trusted agritech platform for farmers, buyers, sellers, experts and businesses — built exclusively for the Makhana trade.

Getting Started

Architecture

API Reference

🚀

Getting Started

Prerequisites, environment variables, local setup, and the build / test / deploy commands for every app in the monorepo.

🏗️

Architecture & Design

System overview, request/data lifecycle, and the core patterns — thin controllers / thick services, queue-based side effects, acceptance-is-the-deal.

🧭

Module Walkthrough

A folder-by-folder tour of the API backend, the web & admin React apps, the Expo mobile app, the Next.js marketing site, and the shared packages.

🔌

API Reference

REST conventions, the auth flow, and every major endpoint group — leads, products, deals, orders, grievances, search and more.

🛠️

Operational Guides

Configuration flags, scheduled jobs, troubleshooting recipes, and the pre-deploy security checklist.

🗄️

Data Model

The 40-model Prisma schema — users, leads, offers/bids, products, batches, deals, orders, inquiries and messaging.

🚢

Deployment & Infrastructure

Railway service topology, the API Docker build & migration setup, and step-by-step provisioning for Supabase, Upstash, Cloudflare R2, MSG91, Firebase, Meilisearch and Sentry.

What is Cropto?

Cropto is a web-based agricultural trading platform for Makhana (Fox Nut) farmers and traders in India (Bihar, Jharkhand, West Bengal, Uttar Pradesh). It connects farmers with traders directly — no middlemen — through a fully transparent open market.

The platform's V2 model is built on:

Sell Leads / Buy Leads — any Active User posts what they want to sell or buy; others engage with Offers (on sell leads) and Bids (on buy leads).
Products & Batches — batch-level inventory with taxonomy (4 L1 / 12 L2 / 42 L3 nodes), GI tagging, per-lot quality metrics, cost basis and realised P&L.
Buy Now — instant, atomic direct-book from a Product detail page.
Deals, Orders & Fulfilment — acceptance materialises an Order; dispatch → buyer receipt → grievance redressal.
Trust Score & Quotas — a 0–100 trust score driving tier badges, and 3-axis daily quotas (posts / views / engagements).

This documentation reflects the actual current code state. The authoritative, in-repo engineering guide is CLAUDE.md at the repository root; this site distils and organises it for browsing.

The monorepo at a glance

App / Package	Stack	Purpose
`apps/api`	Express + TypeScript + Prisma	REST backend, BullMQ workers, business logic
`apps/web`	React 18 + Vite + Tailwind	Farmer/trader trading app (PWA)
`apps/admin`	React 18 + Vite	Admin & sub-admin operations panel
`apps/marketing`	Next.js 15 + Payload CMS 3	Public SEO/marketing site (isolated content DB)
`apps/mobile`	Expo / React Native + NativeWind	Android app (Phase 2)
`packages/*`	TypeScript	Shared `types`, `utils`, `api-client`, `hooks`

Continue to Getting Started →.

CroptoDigital Ecosystem for Makhana Industry

Getting Started

Architecture & Design

Module Walkthrough

API Reference

Operational Guides

Data Model

Deployment & Infrastructure

What is Cropto? ​

The monorepo at a glance ​

What is Cropto?

The monorepo at a glance