Acara Plate - Personalized Nutrition AI Agent

🚀 Live Demo — 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 below.

Table of Contents

• Acara Plate - Personalized Nutrition AI Agent
  • Table of Contents
  • Overview
  • Product Capabilities
    • Personalization Inputs
    • Generated Outputs
    • User Journey Highlights
  • Getting Started
    • Prerequisites
    • Project Setup
    • Environment Configuration
    • Running the Development Server
    • Testing & Code Quality
  • Data Initialization
    • Database Seeding
    • USDA Food Database Import
  • Deployment
    • Self-Hosting Options
    • Production Environment
    • Future Enhancements
  • Accessing Acara Plate
    • Progressive Web App
  • Contributing
  • Code of Conduct
  • License
• 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.

User Journey Highlights

1. Onboarding Questionnaire: Collects deep biometric data, goals, lifestyle factors, dietary preferences, and health constraints to build a user profile.
2. AI Meal Planning: Uses PrismPHP-driven LLM workflows to build structured seven-day plans with queue-backed processing and progress tracking.
3. Meal Plan Management: Offers day-by-day navigation, macro bars, detailed meal cards, and instant grocery list generation.
4. Comprehensive Diabetes Tracking: A unified logbook interface for recording glucose, insulin, carb intake, medications, vitals, and exercise. The system correlates these separate logs to provide 7-day trend analysis, helping users identify patterns (e.g., insulin sensitivity or exercise impact) and improve their Time-in-Range.

Getting Started

Prerequisites

This application is built with:

• PHP 8.4
• Composer 2 — PHP dependency manager
• Node.js 20+
• Laravel 12 — backend API and frontend delivery
• React 19 — frontend UI layer
• Inertia.js — bridges Laravel and React
• PostgreSQL 17+ (pgvector recommended for advanced features)
• Tailwind CSS — utility-first styling

Project Setup

git clone https://github.com/acara-app/plate.git
cd plate
git checkout -b feat/your-feature # or fix/your-fix

Create a feature branch instead of committing directly to main, then install and bootstrap dependencies:

composer setup

composer setup runs Composer and NPM installs, copies .env.example, generates the app key, and executes migrations.

Environment Configuration

Configure the credentials you need in .env. Only the providers you enable in code require keys.

# Optional AI Provider API Keys (choose any subset)
OPENAI_API_KEY=your_openai_key
ANTHROPIC_API_KEY=your_anthropic_key
GEMINI_API_KEY=your_gemini_key
DEEPSEEK_API_KEY=your_deepseek_key
GROQ_API_KEY=your_groq_key
MISTRAL_API_KEY=your_mistral_key
XAI_API_KEY=your_xai_key
OLLAMA_URL=http://localhost:11434 # if using local Ollama

# Optional OAuth
GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret

Running the Development Server

composer run dev

Use npm run build and your Herd .test domain when validating PWA installability. Clear site data if the service worker appears stale.

Testing & Code Quality

Run the full QA suite:

composer test

Targeted commands are also available:

composer test:unit         # Unit & feature tests (100% coverage enforced)
composer test:type-coverage
composer test:lint         # Pint, Rector, ESLint, Prettier
composer test:types        # PHPStan + TypeScript
composer lint              # Auto-fix styling issues

Data Initialization

Database Seeding

php artisan db:seed --class=GoalSeeder
php artisan db:seed --class=LifestyleSeeder
php artisan db:seed --class=DietaryPreferenceSeeder
php artisan db:seed --class=HealthConditionSeeder

USDA Food Database Import

Acara Plate relies on USDA FoodData Central for accurate nutrition data:

1. Download Foundation Foods and SR Legacy Foods (JSON) from FoodData Central.
2. Place the files in storage/sources/.
3. Import using the provided Artisan commands:

php artisan import:usda-food-foundation-data
php artisan import:usda-sr-legacy-food-data

# Use custom paths if needed
php artisan import:usda-food-foundation-data --path=/path/to/foundation.json
php artisan import:usda-sr-legacy-food-data --path=/path/to/legacy.json

Performance & Indexing

• Streaming import efficiently handles large JSON payloads.
• Foundation Foods (~1,200 entries) completes in ~2-5 seconds; SR Legacy (>8,000) in ~10-30 seconds.
• Operations run within database transactions and surface progress in real time.
• Full-text indexes on the description column accelerate search (created on MySQL/PostgreSQL, skipped on SQLite).

Deployment

Self-Hosting Options

• Laravel Forge: Automated provisioning for VPS providers (DigitalOcean, Linode, Vultr, AWS).
• Ploi: Laravel Forge–style GUI for provisioning, deployments, cron management, and queue supervision.
• Laravel Cloud: Fully managed Laravel platform with zero server maintenance.

Production Environment

Our live deployment is hosted on Hetzner with Ploi coordinating releases. We treat this setup as a practical template for similar self-managed installations. The current server runs Ubuntu 22.04 LTS with 2 vCPUs, 2 GB RAM, and 50 GB SSD storage.

• Database: Dedicated PostgreSQL VM isolated from the application server
• Backups: pgBackRest provides automated, incremental backups

Future Enhancements

• IndexedDB caching for limited offline PWA usage (recipes, recent plans)
• Parallelized queue workers for faster meal plan generation

Accessing Acara Plate

The application is available as a regular responsive web app—open your configured domain in any modern browser to use it immediately. Installing the PWA is optional and simply delivers an app-like shell around the same experience.

Progressive Web App

Acara Plate ships as an installable PWA for mobile and desktop:

• Capabilities: Home screen install, standalone window, responsive layout
• Current Limitation: Offline mode is not yet available; an internet connection is required

Installation

• iOS/iPadOS (Safari): Share → Add to Home Screen
• Android (Chrome): Browser menu → Add to Home screen
• Desktop (Chrome/Edge): Click the install icon in the address bar or choose Install from the menu

Updates

• A new deployment becomes active after the service worker installs and the app performs a fresh reload
• If an update appears stuck, complete a hard refresh or clear storage for the domain

Adding New Translations

Acara Plate welcomes translation contributions! The application uses a dual translation system:

Backend (Laravel):

• Translation files are located in lang/{locale}/ (e.g., lang/fr/, lang/es/)
• Copy an existing locale directory (e.g., lang/en/) and translate the PHP array values
• Key files: common.php, auth.php, validation.php, passwords.php, pagination.php

Frontend (React):

• Translations are loaded from Laravel backend via Inertia.js
• React components use react-i18next with the useTranslation() hook
• No separate frontend translation files needed—all translations come from Laravel

To add a new language:

1. Create a new directory in lang/ with the locale code (e.g., lang/es/ for Spanish)
2. Copy all PHP files from lang/en/ to your new locale directory
3. Translate the array values while keeping the keys unchanged
4. Test your translations by switching the app locale

Usage in React Components:

import { useTranslation } from 'react-i18next';

export default function MyComponent() {
    const { t } = useTranslation('common'); // Specify namespace
    return <h1>{t('welcome')}</h1>;
}

Usage in Laravel:

// In controllers or Blade templates
__('common.welcome');
__('auth.throttle', ['seconds' => 60]); // With parameters

Translation Namespaces:

• auth - Authentication-related strings
• common - Common UI elements and general translations
• validation - Form validation messages
• passwords - Password reset and management
• pagination - Pagination controls

Contributions for new languages are highly encouraged! See the Contributing Guide for submission guidelines.

Contributing

We welcome contributions! Review the Contributing Guide for workflows, coding standards, and issue triage details.

Code of Conduct

Please read the Code of Conduct before participating in the community.

License

Acara Plate is released under the O'Saasy License.

Medical Disclaimer

Acara Plate is an open-source project designed for informational and educational purposes only.

Not Medical Advice: This software is not a substitute for professional medical advice, diagnosis, or treatment. Always seek the advice of your physician or other qualified health provider with any questions you may have regarding a medical condition, dietary changes, or blood glucose management.

AI Limitations: Meal plans and nutritional data are generated by large language models (OpenAI, Anthropic Claude, Google Gemini, DeepSeek, Groq, Mistral, XAI, etc.) via PrismPHP. While we strive for accuracy, LLMs can misstate allergens, ingredients, or macro values. Verify critical information independently.

No Liability: Authors and contributors are not liable for adverse effects, health complications, or damages arising from use of the software or reliance on its information.

Emergency: If you think you may have a medical emergency, contact your physician or emergency services immediately.

By using this software, you acknowledge you have read this disclaimer and agree to use the application at your own risk.