plate

![Acara Plate - Personalized Nutrition AI](public/banner-acara-plate.webp)

# Acara Plate - Personalized Nutrition AI Agent

[![License: O'Saasy](https://img.shields.io/badge/License-O'Saasy-blue.svg)](LICENSE)
[![Tests](https://github.com/acara-app/plate/actions/workflows/tests.yml/badge.svg)](https://github.com/acara-app/plate/actions/workflows/tests.yml)
[![Why PHP](https://img.shields.io/badge/Why_PHP-in_2026-7A86E8?style=flat-square&labelColor=18181b)](https://whyphp.dev)

**[🚀 Live Demo](https://plate.acara.app)** — Try Acara Plate now without installation

Acara Plate is an AI-powered personalized nutrition and meal planning platform that creates customized meal plans based on individual user data such as age, weight, height, dietary preferences, and health goals. The platform simplifies meal planning by providing users with tailored recipes, nutritional information, and glucose tracking capabilities that align with their unique needs and lifestyle.

**Multi-Language Support:** Acara Plate is fully internationalized, making personalized nutrition accessible to users worldwide in their preferred language.

> [!IMPORTANT]
> **Disclaimer:** Acara Plate is an AI-powered tool for informational purposes only. It is not a substitute for professional medical advice, diagnosis, or treatment. See the [Medical Disclaimer](#medical-disclaimer) below.

## Table of Contents

- [Acara Plate - Personalized Nutrition AI Agent](#acara-plate---personalized-nutrition-ai-agent)
    - [Table of Contents](#table-of-contents)
    - [Overview](#overview)
    - [Product Capabilities](#product-capabilities)
        - [Personalization Inputs](#personalization-inputs)
        - [Generated Outputs](#generated-outputs)
        - [User Journey Highlights](#user-journey-highlights)
    - [Getting Started](#getting-started)
        - [Prerequisites](#prerequisites)
        - [Project Setup](#project-setup)
        - [Environment Configuration](#environment-configuration)
        - [Running the Development Server](#running-the-development-server)
        - [Testing \& Code Quality](#testing--code-quality)
    - [Data Initialization](#data-initialization)
        - [Database Seeding](#database-seeding)
        - [USDA Food Database Import](#usda-food-database-import)
    - [Deployment](#deployment)
        - [Self-Hosting Options](#self-hosting-options)
        - [Production Environment](#production-environment)
        - [Future Enhancements](#future-enhancements)
    - [Accessing Acara Plate](#accessing-acara-plate)
        - [Progressive Web App](#progressive-web-app)
    - [Contributing](#contributing)
    - [Code of Conduct](#code-of-conduct)
    - [License](#license)
- [Medical Disclaimer](#medical-disclaimer)

## Overview

Acara Plate is a Laravel 12 application that pairs Inertia (React) with Tailwind CSS to deliver a seamless AI-assisted meal planning experience. Powered by PrismPHP, it generates seven-day meal plans that adapt to each user's biometric data, preferences, and goals while tracking key wellness metrics such as glucose readings.

**Internationalization:** The application features comprehensive multi-language support with translations across all user-facing interfaces, including React components (via react-i18next), Laravel Blade templates, and email notifications.

## Product Capabilities

### Personalization Inputs

- **Biometrics:** Age, sex, height, weight, BMI, BMR, and TDEE calculations.
- **Goals:** Weight loss, muscle gain, maintenance, metabolic health, endurance, flexibility.
- **Lifestyle:** Activity level, occupation, and sleep patterns.
- **Preferences:** Vegan, vegetarian, keto, paleo, gluten-free, lactose-free, allergen exclusions, and dislikes.
- **Health Conditions:** Type 2 Diabetes, Pre-diabetes, Hypertension, Heart Disease, and other nutrition-sensitive conditions.

### Generated Outputs

- **Smart Meal Planning:**
    - Calorie targets strictly aligned with user goals.
    - Precise Macronutrient distribution (protein, carbs, fat).
    - Meal-by-meal recipes with quantities, portions, and prep guidance.
    - Grocery list generation (USDA-verified) with macro visualizations.
    - Printable meal plans with semantic HTML and PDF export.
- **Diabetes Management Logbook:**
    - **Glucose:** Tracking with context (fasting, pre/post-meal) and trend analytics.
    - **Insulin:** Logging for units and types (Bolus/Basal) to correlate doses with glucose outcomes.
    - **Carbs & Food:** Manual carbohydrate logging to track real-world intake vs. planned goals.
    - **Meds & Vitals:** Tracking for medication adherence, blood pressure, weight, and A1C.
    - **Exercise:** Activity logging to monitor the impact of movement on blood sugar levels.
- **Analytics & Insights:**
    - "Time-in-Range" visualization and glucose variability trends.
    - Automated analysis notifications with actionable recommendations via email.
- **Internationalization:**
    - Full multi-language support with extensible translation framework.
    - Seamless language switching across all interfaces.
    - Localized email notifications and printable documents.
    - Easy to add new languages via translation files.

### How Users Experience Acara Plate

**1. Tell Us About Yourself**  
Answer a few questions about your body, goals, and lifestyle. Whether you're managing Type 2 diabetes, trying to lose weight, or just eating healthier — Acara Plate builds your profile in under 3 minutes.

**2. Get Your Personal Meal Plan**  
The AI creates a complete 7-day meal plan tailored to your calorie targets, macro needs, and food preferences. Each recipe includes portions, prep steps, and nutrition facts. No more guessing what to eat.

**3. Shop with Confidence**  
Generate a consolidated grocery list organized by store section. Everything you need for the week, no wasted ingredients, no impulse buys.

**4. Track What Matters**  
Log your glucose readings, meals, insulin, and activity in one place. Spot patterns — like how that afternoon coffee affects your numbers or which workouts keep you stable.

**5. Ask Anything, Anytime**  
Stuck at a restaurant? Wondering if a food will spike you? Chat with the AI Nutritionist for instant, personalized guidance based on your actual data.

### AI Nutritionist

Your personal AI-powered nutrition assistant, available 24/7:

- **Conversational Guidance:** Ask anything naturally — "What should I order at Chipotle?" or "Will this spike my blood sugar?"
- **Personalized Advice:** Context-aware recommendations based on your profile, goals, and glucose patterns
- **Restaurant Help:** Navigate any menu with confidence, from fast food to fine dining
- **Meal Planning:** Get day-of suggestions or full week plans based on your constraints
- **Glucose Predictions:** Understand how foods will affect your blood sugar before you eat

[Learn more about AI Nutritionist →](https://plate.acara.app/ai-nutritionist)

### Food Database

USDA-verified nutrition information at your fingertips:

- **310+ Foods:** Comprehensive database with glycemic index, glycemic load, and full nutrition facts
- **Diabetes-Focused:** Each food includes safety assessments and glucose impact predictions
- **Searchable:** Filter by category, GI impact, or search by name
- **Free & Open:** Browse the full database without signup at [plate.acara.app/food](https://plate.acara.app/food)

### Free Tools

No registration required — try these instantly:

- **Spike Calculator:** Check if any food will spike your blood sugar. Just type a food name and get instant glucose impact predictions.
  → [Try Spike Calculator](https://plate.acara.app/tools/spike-calculator)

- **Snap to Track:** Take a photo of your meal and get instant nutrition facts. AI-powered food recognition with macro breakdown.
  → [Try Snap to Track](https://plate.acara.app/tools/snap-to-track)

## Getting Started

### Prerequisites

This application is built with:

- **PHP 8.4**
- **Composer 2** — PHP dependency manager
- **No

[truncated…]