kiwi/docs/user-guide/inventory.md
pyr0ball 01aae2eec8
Some checks failed
CI / Backend (Python) (push) Has been cancelled
CI / Frontend (Vue) (push) Has been cancelled
CI / Backend (Python) (pull_request) Has been cancelled
CI / Frontend (Vue) (pull_request) Has been cancelled
fix: recipe enrichment backfill, main_ingredient browser domain, bug batch
Recipe corpus (#108):
- Add _MAIN_INGREDIENT_SIGNALS to tag_inferrer.py (Chicken/Beef/Pork/Fish/Pasta/
  Vegetables/Eggs/Legumes/Grains/Cheese) — infers main:* tags from ingredient names
- Update browser_domains.py main_ingredient categories to use main:* tag queries
  instead of raw food terms; recipe_browser_fts now has full 3.19M row coverage
  (was ~1.2K before backfill)

Bug fixes:
- Fix community posts response shape (#96): add total/page/page_size fields
- Fix export endpoint arg types (#92)
- Fix household invite store leak (#93)
- Fix receipts endpoint issues
- Fix saved_recipes endpoint
- Add session endpoint (app/api/endpoints/session.py)

Shopping list:
- Add migration 033_shopping_list.sql
- Add shopping schemas (app/models/schemas/shopping.py)
- Add ShoppingView.vue, ShoppingItemRow.vue, shopping.ts store

Frontend:
- InventoryList, RecipesView, RecipeDetailPanel polish
- App.vue routing updates for shopping view

Docs:
- Add user-facing docs under docs/ (getting-started, user-guide, reference)
- Add screenshots
2026-04-18 15:38:56 -07:00

2.1 KiB

Inventory

Kiwi pantry view

The inventory is your pantry. Every item you add gives Kiwi the data it needs to show pantry match percentages, flag expiry, and rank recipe suggestions.

Adding items

By barcode

Tap the barcode scanner icon. Point your camera at the barcode on the product. Kiwi checks the open barcode database and fills in the product name and category.

If the product isn't in the database, you'll see a manual entry form pre-filled with whatever was decoded from the barcode — just add a name and save.

By receipt

Upload a receipt photo in the Receipts tab. After the receipt is processed, approved items are added to your pantry in bulk. See Receipt OCR for details.

Manually

Click Add item and fill in:

Field Required Notes
Name Yes What is it?
Quantity Yes Number + unit (e.g., "2 cans", "500 g")
Expiry date No Used for expiry alerts and leftover mode
Category No Helps with dietary filtering
Notes No Storage instructions, opened date, etc.

Editing and deleting

Click any item in the list to edit its quantity, expiry date, or notes. Items can be deleted individually or in bulk via the selection checkbox.

Expiry alerts

Kiwi flags items approaching expiry with a color indicator:

  • Red: expires within 2 days
  • Orange: expires within 7 days
  • Yellow: expires within 14 days

The Leftover mode uses this same expiry window to prioritize nearly-expired items in recipe rankings.

Inventory stats

The stats panel (top of the Inventory page) shows:

  • Total items in pantry
  • Items expiring this week
  • Breakdown by category
  • Items added this month

CSV export

Click Export to download your full pantry as a CSV file. The export includes name, quantity, category, expiry date, and notes for every item.

Bulk operations

  • Select multiple items with the checkbox column
  • Delete selected — remove items in bulk
  • Mark as used — remove items you've cooked with (coming in Phase 3)