All help topics Getting started
How Residual works
Residual is an iPhone meal planner and tracker for people who eat to calorie and macro targets. You plan the day first, log what you actually eat, and when the two don’t match, the meals still ahead change size so the day still lands.
The idea
Most trackers record what you ate and show what’s left. Working out what to eat with what’s left is up to you. Residual starts from a plan instead. The first page you see in the app puts it this way: food tracking without a plan is just keeping score.
So a day in Residual has two sides. The plan is what you mean to eat. The log is what you ate. Logging never overwrites the plan; it sits beside it, and the difference between them is what the app works with.
Four parts
Your targets are calories, protein, carbs and fat, each with a range on either side. Landing anywhere inside a range counts. You set the order they land in, and any of them can float. See Set your daily targets.
Then you plan. Build the day yourself, or let a planner draft it from your pantry, your saved meals and what you tell it. Claude writes the plan if you allow it; otherwise Apple Intelligence on your iPhone does, or Residual builds it from your own foods. Whoever writes it, Residual’s solver sizes every portion so the plan lands in range. See Plan a day with AI.
Then you eat, and log it. When you eat a meal as planned, one swipe logs it. When something was different, you change only the food that differed. See Log what you actually ate.
Then real life happens. Lunch ran over, or you skipped the rice. The gap between where the day now lands and your targets is the residual. Close it, and the meals you haven’t eaten keep their foods and get a little bigger or smaller. Nothing moves until you apply it. See Close the residual.
Where AI fits
AI drafts the meals: which foods, and roughly how much. Re-sizing a day is plain arithmetic, the same answer every time, with no AI in it. A portion never goes below about half or above about double what was planned, so dinner stays dinner. When the meals ahead can’t absorb what happened, Today says so plainly rather than shrinking a food to a token portion. When the day can’t land covers what to do then.
What it doesn’t do
Residual doesn’t change your targets from your weight trend. It lands the targets you set, or the ones its calorie calculator works out from your body, activity and goal. Whether you lose, gain or hold weight comes from those numbers: set calories under what you burn, land them most days, and that is what moves the scale. It works the same way for cutting, bulking or holding steady.
It doesn’t import from other trackers, and there is no dashboard for a coach to follow along. Foods come from USDA FoodData Central, barcodes, and Nutrition Facts labels you photograph. Any days you pick export as a spreadsheet, so your history is never locked in.
Residual is a tool for hitting numbers you choose. It doesn’t know your medical history or allergies. Talk to a doctor or registered dietitian before changing how you eat.