pyr0ball
01aae2eec8
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
52 lines
2.1 KiB
Markdown
52 lines
2.1 KiB
Markdown
# Quick Start
|
|
|
|
This guide walks you through adding your first pantry item and getting a recipe suggestion. No LLM backend needed for these steps.
|
|
|
|
## 1. Add an item by barcode
|
|
|
|
Open the **Inventory** tab. Tap the barcode icon or click **Scan barcode**, then point your camera at a product barcode. Kiwi looks up the product in the open barcode database and adds it to your pantry.
|
|
|
|
If the barcode isn't recognized, you'll be prompted to enter the product name and details manually.
|
|
|
|
## 2. Add an item manually
|
|
|
|
Click **Add item** and fill in:
|
|
|
|
- **Name** — what is it? (e.g., "Canned chickpeas")
|
|
- **Quantity** — how many or how much
|
|
- **Expiry date** — when does it expire? (optional but recommended)
|
|
- **Category** — used for dietary filtering and pantry stats
|
|
|
|
## 3. Upload a receipt
|
|
|
|
Click **Receipts** in the sidebar, then **Upload receipt**. Take a photo of a grocery receipt or upload an image from your device.
|
|
|
|
- **Free tier**: the receipt is stored for you to review; line items are entered manually
|
|
- **Paid / BYOK**: OCR runs automatically and extracts items for you to approve
|
|
|
|
## 4. Browse recipes
|
|
|
|
Click **Recipes** in the sidebar. The recipe browser shows your **pantry match percentage** for each recipe — how much of the ingredient list you already have.
|
|
|
|
Use the filters to narrow by:
|
|
|
|
- **Cuisine** — Italian, Mexican, Japanese, etc.
|
|
- **Meal type** — breakfast, lunch, dinner, snack
|
|
- **Dietary** — vegetarian, vegan, gluten-free, dairy-free, etc.
|
|
- **Main ingredient** — chicken, pasta, lentils, etc.
|
|
|
|
## 5. Get a suggestion based on what's expiring
|
|
|
|
Click **Leftover mode** (the clock icon or toggle). Kiwi re-ranks suggestions to surface recipes that use your nearly-expired items first.
|
|
|
|
Free accounts get 5 leftover-mode requests per day. Paid accounts get unlimited.
|
|
|
|
## 6. Save a recipe
|
|
|
|
Click the bookmark icon on any recipe card to save it. You can add:
|
|
|
|
- **Notes** — cooking tips, modifications, family preferences
|
|
- **Star rating** — 0 to 5 stars
|
|
- **Style tags** — quick, comforting, weeknight, etc.
|
|
|
|
Saved recipes appear in the **Saved** tab. Paid accounts can organize them into named collections.
|