The Pantry

🚪 Opening the pantry

📷 Adding an item

Tap the floating + on the pantry list. You land on the Capture page with two photo slots. This is the bit people get wrong, so read carefully.

The two photos

1. The nutrition label (required)

This is the photo the AI actually reads. It needs to clearly show:

• The "per 100g" column (or the serving size, if that's all the label gives you).
• Carbs, fibre, fat, protein, calories — all legible.
• The serving size in grams if it's printed (e.g. "Serving size: 32g"). Saves you a step later.

Tip: hold the pack flat, fill the frame, decent light. A blurry label photo means the AI guesses, and then you'll be hand-typing macros anyway.

2. The front of the pack (optional, but do it)

This one's not for the macros — those come from the label. The front shot helps the AI nail the brand and product name (so "Califia Farms Unsweetened Almond Milk" doesn't get filed as "almond milk" and confused with the sugary kind).

Skip it if you don't care about the name being tidy. The macros will still be correct.

Then tap one of two buttons

• Analyze — sends both photos off, AI extracts the macros, brand, product name and serving size. This is what you want 99% of the time.
• Save photos — uploads the photos without running the AI. Use this if you're just replacing a blurry label on an item you've already added.

✅ Reviewing what the AI got

After Analyze finishes (a few seconds), you land on the edit page with everything pre-filled. Your job is to skim, fix anything obviously wrong, and save.

What you'll see:

• Name — the product (required).
• Brand — optional but tidy.
• Per-100g macros — total carbs, fibre, fat, protein, calories, sugar alcohols.
• Net carbs — calculated for you, can't be edited directly. Fix the total or the fibre instead.
• Serving (optional) — grams plus a label like "1 wrap" or "1 cup".
• Notes — free-form, e.g. "low-carb tortilla — only at Woolies".

Happy with everything? Tap Save. The item syncs in the background and shows up in your pantry list immediately.

📋 The pantry list

Each item shows the front-of-pack thumbnail (if you took one), the name, the brand, the net carbs per 100g, and the calories / protein / fat. Tap any card to edit.

• Search bar at the top filters by name or brand. Useful once you've got 20+ items.
• The counter in the header ("X of 100") is your remaining budget — see Limits below.
• Tap a card to edit anything: macros, name, photos, notes.

🎯 When a meal uses a pantry item

Here's where the work pays off. When you snap a meal and the AI identifies a food that matches something in your pantry, it'll quietly swap the AI's guess for your macros — the ones from the label you scanned.

How you know it happened

The food card on the meal review screen shows a small teal "Pantry" pill (with an apple icon) in the bottom-right corner. The macros on the card are now your pantry item's per-100g numbers, scaled to the portion the AI estimated.

Long-press or tap the "Pantry" pill to see which item it matched — the action sheet header tells you, e.g. "Matched: Califia Farms Almond Milk".

If the match is right, do nothing — just save the meal. The macros stick.

🔄 Swapping to a different pantry item

Two ways to override the match. Both apply instantly — no save needed at this point, the macros on the card update as soon as you choose.

Option A — Tap the "Pantry" pill

1. On the food card, tap the teal Pantry pill (bottom-right).
2. An action sheet appears titled "Matched: [current item]".
3. Pick one:
   • Revert to AI guess — drops the pantry link, brings back the AI's original name and macros.
   • Use [alternative] — swaps to that pantry item's macros. The AI suggests these based on what it saw in the photo.

Option B — Tap a pantry chip

Just below the food card you'll sometimes see a small row titled "Or use from your pantry" with a few teal pill chips — alternative pantry items the AI thinks could fit. Tap a chip; macros change immediately. Same effect as the action sheet, one tap less.

💾 Saving a pantry item from a meal you just logged

You're in the middle of logging a meal, the AI's identified an item, and you realise you eat this one all the time but haven't added it to your pantry yet. No need to back out and start over.

1. On the food card, find the small Save to Pantry checkbox (bottom-right, teal).
2. Tick it. The item's macros, name and brand from the card will be used as the starting values for the new pantry entry.
3. Save the meal as normal. A new pantry item is created in the background.

The new pantry item won't have a nutrition-label photo (you didn't scan one), so the macros are whatever the AI estimated. If you want to upgrade it later, open the item from the pantry list, tap Scan Label, and snap the real label.

🚧 Limits, deletes & gotchas

The 100-item cap

The pantry holds 100 items. When you hit the cap, the floating + button hides and a banner appears at the bottom saying "Pantry is full. Remove an item to add another." Honestly, 100 is a lot — if you're hitting the wall, prune things you tried once and never bought again.

Deleting an item

1. Open the item from the pantry list.
2. Scroll down and tap Delete from pantry (red text, bottom of the page).
3. Confirm — you'll see "'[Item Name]' will no longer be suggested in meal analyses."

Things the pantry doesn't do (yet)

• Quantity / stock tracking. Logging a meal that uses a pantry item doesn't decrement anything. The pantry is a macro reference, not an inventory app — if you want to know whether you've got eggs left, look in the fridge.
• Barcode scanning. The button's there with a "Coming soon" label. For now: scan the label instead.
• Auto-deduplication. If you try to save a second item with the exact same name as an existing one, you'll get blocked with a message suggesting you edit the original instead.