# MealPA - AI-Powered Meal Planning Assistant

> MealPA is an intelligent nutrition assistant that simplifies meal discovery for Nigerian and Continental cuisines. It combines mood analysis, time-of-day logic, and health goals to generate personalized meal plans, automates shopping lists, and ensures dietary compliance for medical conditions.

## Core Features

- **AI Meal Engine**: Generates personalized meal plans based on user mood ('Stressed', 'Energetic'), time of day, and specific health goals (Weight Loss, Maintenance, Muscle Gain).
- **Medical & Dietary Intelligence**: Built-in rule engine for 6+ medical conditions including Diabetes, Hypertension, Ulcer, PCOS, Cholesterol, and GERD. Automatically filters forbidden ingredients and prioritizes beneficial ones.
- **Smart Shopping List**: Advanced two-way synchronization between the Meal Plan and Shopping List. Automatically aggregates ingredients, handles manual additions, and maintains state across updates.
- **Offline Resilience**: Robust offline-first architecture allows users to view plans and manage lists without internet access, syncing changes automatically when connectivity is restored.
- **Nutritional Analytics**: Real-time calculation of macro-nutrient splits (Carbs, Protein, Fat) and daily calorie tracking to ensure users stay within their health targets.

## Technical Specifications

- **Frontend**: React 18, Vite, TypeScript, Tailwind CSS, Shadcn UI.
- **Backend**: Supabase (PostgreSQL, Authentication, Real-time Subscriptions).
- **Architecture**: Client-side logic with robust local storage caching and optimistic UI updates for high performance.
- **Deployment**: Progressive Web App (PWA) ready, hosted on Vercel.

## Links

- **Home**: https://mealpa.com
- **App**: https://mealpa.com/app
- **Feedback**: https://mealpa.com/feedback