Rwanda Cancer Relief
# Rwanda Cancer Relief Monorepo
This repository hosts the Rwanda Cancer Relief product suite. The project uses a Supabase-first architecture and deploys the customer-facing experience to Vercel. Turbo and pnpm coordinate tasks across applications and shared packages.
## Table of Contents
- Overview
- Repository Layout
- Key Technologies
- Prerequisites
- Environment Setup
- Development Workflow
- Quality and Testing
- Supabase Operations
- Dashboard Data Tooling
- Documentation
- Deployment
- Support
## Overview
The product delivers a secure onboarding and care-management workflow for patients, counselors, and administrators. Authentication, data storage, role-based access control, and analytics run entirely on Supabase. The web application is a Next.js 16 App Router project using Cache Components and a shared design system.
## Repository Layout
| Path | Description |
| --- | --- |
| `apps/web` | Next.js 16 application that powers the public site and authenticated dashboards |
| `packages/ui` | Shared component library built on shadcn/ui and Radix primitives |
| `packages/eslint-config` | Centralized ESLint configurations for the monorepo |
| `packages/typescript-config` | Shared TypeScript base configurations |
| `scripts/` | Operational scripts (seeding, data validation, utilities) |
| `supabase/` | Database migrations, Edge Functions, and configuration |
| `docs/` | Current documentation set |
| `docs/legacy/backend/` | Archived REST backend documentation kept for reference |
## Key Technologies
- Next.js 16 with App Router, Cache Components, and Turbopack
- React 19 with TypeScript 5.7
- Supabase (Auth, Database, Storage, Edge Functions, Realtime)
- pnpm 8+ with workspaces and Turbo 2 for task orchestration
- Tailwind CSS 4 and shadcn/ui component patterns
- AI Gateway integrations via Vercel AI SDK and ElevenLabs components
## Prerequisites
- Node.js 20.x (match the engine in `package.json`)
- pnpm 8.x or newer (`corepack enable` is recommended)
- Supabas …