> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ironcoaching.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Logging food

> Search, recents, favorites, copy yesterday, and quick-add macros.

The nutrition logger gives you four ways to record what you ate today.
Whichever you use, the macro totals at the top of the screen update live so
you can see how today is tracking against your plan's targets.

## Daily totals ring

A sticky neon progress ring sits above the tabs at all times. Calories live
in the centre; protein, carbs, and fat ring segments orbit them. Each
segment glows cyan under 80% of target, green between 80–100%, and pink
when you've gone over — so a glance tells you where today stands without
opening the plan tab.

## Tabs: Log · Plan · Wellness

The body of the page is split into three tabs:

* **Log** — search and add food, recents, favorites, quick-add macros,
  copy yesterday. Default landing tab.
* **Plan** — your assigned macro plan with per-meal targets. Ticking a
  planned meal as **Eaten** writes the matching entry into Log
  automatically (and unticking removes it). The ring at the top reflects
  it instantly.
* **Wellness** — sleep, mood, energy, water, training flag, and free-form
  notes. Saves on tap; data flows into your coach's weekly review.

You can also use the **left / right arrows** next to the date header to
scrub back through past days. Edits to older days are allowed if your
coach hasn't locked them.

## Search

Type the name of a food into the search bar at the top of the **Log** tab.
After about a third of a second the list populates with hits from the food
database (Open Food Facts) plus any custom foods your coach has authored.

* Use **arrow up / down** to move through the list.
* Press **Enter** to pick the highlighted food, or click any row.
* Press **Esc** to dismiss the dropdown without picking.

When you pick a food a small modal opens so you can adjust the **quantity**
(grams, ml, pieces, or servings depending on the food) and the **meal slot**
(Breakfast, Lunch, Dinner, Snacks). The default meal slot is based on the
time of day; tap the dropdown to override it.

## Recents

Below the search bar you'll see your last ten distinct foods. Tap any tile
to open the same quantity/meal-slot modal pre-filled with that food. This
is the fastest path for foods you eat often.

## Favorites

Star a logged entry (or any food in your recents) to pin it to the
**Favorites** strip. Favorites stay across days and are the second-fastest
re-log path. Star again to unfavorite.

## Quick add macros

Don't have a food in mind? Expand **Quick Add Macros** to enter raw P/C/F
totals. Calories are computed automatically (`4·protein + 4·carbs + 9·fat`).
Use this when you ate something you can't easily look up — a guesstimate
beats no record.

## Copy yesterday

Tap **Copy yesterday** to duplicate your previous day's entries onto today.
The dialog tells you how many entries will be copied; existing matches on
the same meal slot + food are skipped automatically. Great for routine days.

## Editing and deleting

Each entry has pencil and trash icons:

* **Pencil** lets you edit the quantity in place — macros recompute
  proportionally.
* **Trash** removes the entry. The totals at the top update immediately.

Every change saves the moment you confirm it; there's no separate **Save**
button on the Log tab. A small "Saved" indicator flashes in the header
after each autosave. If autosave ever fails (offline, server error) the
indicator turns pink and the entry stays editable until the next attempt
succeeds.
