Welcome
What MacroMath is, the problem it solves and who it is for.
MacroMath is a cross-platform mobile app (Android and iOS), built with Flutter, that simplifies day-to-day nutrition through a visual, intuitive and personalized approach. In a single ecosystem it combines rigorous calorie and macronutrient tracking with an AI-powered nutrition assistant — MacroAI — able to build meal plans and to computationally analyze photos of food and shopping receipts.
The problem it solves
Most people know their nutritional goals but lack the practical knowledge about how meals should be composed to reach them — something that frequently ends in food waste. MacroMath answers this gap with three pillars:
- AI-assisted meal planning — plans tailored to your profile.
- Smart Pantry — you know what you have, what's missing and what's running low.
- Progress tracking — weight and macro evolution over time.
All designed to boost retention and long-term consistency.
Who the app is for
It's meant for anyone who wants to optimize their diet — for health, aesthetics or athletic performance. It serves both the everyday user who wants to track their diet without hassle and athletes who require detailed metrics. Its focus on Portuguese retail products and its multilingual support ensure broad reach.
Who this documentation is for
| Audience | What you'll find here |
|---|---|
| Users | How to use every screen and feature of the app. |
| Team / future me | Concepts, formulas and architecture decisions. |
| Developers | Tech stack, AI integration, data model and security. |
Alignment with the 2030 SDGs
The project aligns with three United Nations Sustainable Development Goals:
- SDG 3 — Good Health and Well-being: promotes healthy eating habits.
- SDG 9 — Industry, Innovation and Infrastructure: integrates advanced AI models.
- SDG 12 — Responsible Consumption and Production: fights food waste through the Smart Pantry and predictive shopping lists.
How it's organized
- Introduction — overview and first steps.
- User guides — screen by screen, step by step.
- Reference — formulas, sources and data.
- Architecture — how the app is built.
New here?
Head to Get started to install and set everything up in minutes.