HealtyHelp is an open-source web application that helps users eat better through a curated recipe catalog, an AI-powered nutrition assistant (NutriBot), daily calorie tracking, and personalized dietary recommendations. Whether you’re self-hosting or contributing, this documentation covers everything from spinning up the dev environment to every REST API endpoint.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/JuanSebasSV/healtyhelp/llms.txt
Use this file to discover all available pages before exploring further.
Quickstart
Get the server and client running locally in under 10 minutes.
Architecture
Understand how the React frontend, Express API, and MongoDB fit together.
Core Features
Explore recipes, nutrition tracking, the NutriBot chatbot, and favorites.
API Reference
Full reference for all REST endpoints — auth, recipes, consumos, chat, and admin.
What’s Inside
HealtyHelp ships as a monorepo with a React/Vite frontend and an Express + MongoDB backend. Here’s what the platform offers:Recipe Catalog
Browse, filter, and search hundreds of recipes with complete nutritional data including macros, vitamins, and amino acids.
NutriBot AI Chat
LLaMA 3.3 70B via Groq answers nutrition questions and recommends recipes tailored to each user’s health profile.
Nutrition Tracking
Log meals by day, week, or month. Get visual macro summaries and calorie progress toward your TDEE goal.
Admin Panel
Full admin dashboard with user management, recipe CRUD, image moderation, AI prompt control, and terms versioning.
Get Started in 4 Steps
Clone and install dependencies
Clone the repository and install packages for both the server and the client.
Configure environment variables
Copy the
.env templates and fill in your MongoDB URI, JWT secret, Groq API key, and Google OAuth credentials.Start the development servers
Run
npm run dev in both server/ and client/ to launch the API on port 5000 and the frontend on port 5173.The full step-by-step setup guide with all commands is on the Quickstart page.