The MacroMath documentation
Everything about the AI nutrition app — how to use it, how macros are calculated, and how the product is built. One place, always up to date.
- 5tabs
- 13migrations
- 3food sources
- 5languages
- 17/17tests passing
AI-assisted planning
MacroAI generates personalized meal plans and rebalances them deterministically to hit your targets.
Smart pantry
Kitchen inventory with stock alerts, predictive shopping lists and Pantry-First mode.
Progress tracking
Weight, macros and evolution over time in clear charts, for long-term consistency.
Introduction
What MacroMath is, the problem it solves and how to get started.
OpenUser guides
Screen by screen: home, diet, MacroAI, pantry, progress and profile.
OpenReference
The macro formulas, the food data sources and the data model.
OpenArchitecture
App layers, the tech stack, the MacroAI integration and testing.
OpenDiet and macros
Protein, carb, fat and water targets, with real-time progress.
Logging meals
Search, barcode scanning or photo analysis.
MacroAI assistant
An AI nutritionist that builds plans and answers questions.
Pantry and shopping
Inventory, stock alerts and AI-generated shopping lists.
Progress
Weight history and weekly macro and calorie charts.
Profile and settings
Goals, custom meals, security, languages and themes.
Every layer has a page with the full detail — click to go deeper.
- Mobile appFlutter · Dart 3.9.xSee more →
- Backend (BaaS)Supabase · PostgreSQL · RLSSee more →
- Artificial intelligenceGemini 2.5 FlashSee more →
- Food dataLocal PT · FatSecret · OFFSee more →
- Local storageHiveSee more →
- Chartsfl_chartSee more →
- Data model13 migrations · PostgreSQLSee more →
- BillingStripe · checkout + portalSee more →
- Docs siteNext.js · FumadocsSee more →
- Marketing siteAstro · PT/EN/ESSee more →
The three repositories of the MacroMath ecosystem.