Kramya

An OPD queue platform for patients to wait away from the clinic and arrive closer to their turn. ETA accuracy, clear uncertainty and recovery from queue changes are core product requirements.

Directory	Responsibility
apps/api	NestJS API, Prisma/PostgreSQL, queue commands, ETA, payments, FCM outbox
apps/web	Next.js staff/admin console and public demo
apps/native	Kotlin/Jetpack Compose Android patient app
packages/contracts	Shared Zod/TypeScript API contracts; mirror changes in Kotlin models
packages/config	Shared TypeScript/ESLint configuration

The Expo/React Native patient application was retired at the founder's request on 16 October 2026. Android is the current patient platform. See the native build/device guide.

Use the pinned Node version in .node-version and pnpm version in package.json.

corepack pnpm install --frozen-lockfile
corepack pnpm db:up
corepack pnpm build
corepack pnpm test

API integration tests use a separate local *_test database. Never point them at hosted Supabase. The hosted environment remains disposable staging; see the staging runbook and security access design.

Production work follows the safeguard rollout. Hands-on phone testing and the complete UI/workflow review are saved for the final phase in TESTING.md. The current Android visual direction is documented here.

Start with one supervised clinic pilot and record prediction error, window coverage, physical waiting time, late/missed arrivals and staff effort before expanding to 3–4 clinics. Automated tests verify behavior; observed outcomes establish whether the product saves patients time.

See the ETA measurement and supervised pilot guide.