kclaudeeager/personalyzed-meal-planner

An adaptive meal planning and nutrition recommendation system designed initially for middle-class Rwandan households and professionals. # Adaptive Meal Planning Platform AI-powered personalized meal planning for Rwandan households. Built with a modular monorepo architecture for rapid iteration and AI-agent-friendly development. ## 🏗️ Architecture ``` apps/ api/ → NestJS REST API (port 4000) web/ → Next.js 15 admin dashboard (port 3000) mobile/ → Expo React Native app packages/ types/ → Shared TypeScript interfaces & enums database/ → Prisma schema & client shared/ → Common utilities & constants config/ → Zod-validated environment config recommendation-engine/ → Rule-based meal scoring ui/ → Shared UI components (placeholder) infra/ docker/ → Docker Compose (PostgreSQL + Redis) ``` ## 🚀 Getting Started ### Prerequisites - Node.js ≥ 20 - pnpm ≥ 9 - Docker (for PostgreSQL & Redis) ### Setup ```bash # 1. Install dependencies pnpm install # 2. Copy environment variables cp .env.example .env # 3. Start databases docker compose -f infra/docker/docker-compose.yml up -d # 4. Generate Prisma client pnpm db:generate # 5. Push schema to database pnpm db:push # 6. Start development servers pnpm dev ``` ### Individual Apps ```bash pnpm dev:api # Start API only (localhost) pnpm dev:web # Start web dashboard only (localhost) ``` ### API Documentation Swagger UI is available at: `localhost` ## 🍽️ Key Features | Feature | Description | Status | |---------|-------------|--------| | **Personalized Recommendations** | Rule-based scoring engine (preferences, budget, time, nutrition, history) | ✅ Phase 1 | | **Meal Catalog** | Full CRUD with ingredients, nutrition profiles, video references | ✅ | | **Feedback System** | Rate meals (1-5), mark as liked/disliked/too expensive/etc. | ✅ | | **Weekly Meal Planner** | Calendar-based planner with AI-generated suggestions from recommendations | ✅ New | | **Shopping List Generator** | Auto-generate categorized shopping lists from meal pl …