Slovenščina: navodila za uporabo · Privacy · Terms
User guide
FridgeAI: photograph your fridge, AI recognises the food, tracks expiry dates, suggests recipes and builds a shopping list based on your household's habits.
1. First steps
- Open the app and click Sign up. Enter a username (an e-mail address works too) and a password (at least 8 characters), and tick the consent box for the terms of use and privacy policy.
- If you are joining a family that already uses the app, also enter the household code (the owner finds it in Settings).
- In the Me tab enter allergies, diet and household size. All recipes and lists take these into account.
- On first sign-in a setup wizard guides you through diet, kitchen appliances and the family code in three steps (each step can be skipped; restart it in Me → Account).
- Click Scan your fridge.
Navigation: bottom tabs (Home, Scan, Stock, Recipes, Shop, Me). The ‹ Back button at the top left goes one step back, and clicking FridgeAI returns home. Switch the language (Slovenian / English) with the SL | EN buttons in the top bar or on the login screen; the choice is saved to your settings, so the AI also answers in that language.
2. Fridge scan
- Open the fridge door, make sure there is light and photograph the shelves (several photos are fine: click Choose several photos and select them at once; photos are processed one after another and duplicates are merged). For a single photo use Take a photo (camera).
- Within seconds the AI lists the food with quantity, category and an estimated shelf life.
- Review the list: fix names or quantities and untick what you do not want to add. Items already in stock are marked and unticked by default.
- Click Add selected to inventory.
Quick text entry: type e.g. 2 l milk, 6 eggs, 1 kg potatoes and click Parse. The AI turns the text into a list of foods that you confirm just like after a scan.
Each photo and each text entry is one AI call in the monthly quota of the free plan. Photos are processed by the AI provider and are not stored on our servers.
Tip: best results come from sharp photos that cover one shelf at a time.
3. Expiry date scan
When you put groceries away, photograph the printed date on the packaging.
- Scan → Expiry. Optionally type the name of the food (it helps matching with your stock).
- The AI reads the date and its type (use by or best before).
- Choose whether to attach the date to an existing item or create a new one, check the date and click Save expiry.
4. Receipt scan
Instead of photographing each product, photograph the store receipt (Scan → Receipt). The AI turns abbreviations into food names, estimates expiry dates and flags non-food items. Confirm the list and everything goes into stock; the app remembers the purchase for learning your habits.
4a. Barcode
For packaged products open Scan → Barcode.
- Click Scan with camera (if your browser supports it) and point the camera at the barcode, or type the digits under Enter code (EAN) and click Search.
- We look the product up in the open Open Food Facts database (name, brand, quantity); only the barcode number is sent. This does not use the AI quota.
- Check the name, category, quantity and expiry (suggested by product type) and click Add to inventory.
If the product is not in the database, enter it manually.
iPhone (Safari, Chrome) has no built-in reader, so the app uses its own (ZXing): click "Scan with camera" and hold the code 10–20 cm from the camera; if live scanning does not work, use Photograph barcode (close, sharp, no glare) or type the digits under the code.
5. Inventory
- Food is grouped by category; the colour tells you how many days remain (red = expired or today, orange = 3 days or less, green = fine).
- ✅ Consumed and 🗑️ Discarded both remove an item from stock. The difference matters: discarded means it went in the bin, and the app will suggest smaller quantities.
- 📅 edits the expiry date. ➕ Add manually is for food without a photo.
- In a shared household the app shows who added an item.
- Locations: each item is in the fridge, the 🧊 freezer (❄️) or the 🥫 pantry. Filter by location at the top; frozen food defaults to the freezer and leftovers get a 3-day expiry.
- Prices: a receipt scan stores the price with the item; you can edit price and location (✏️) or enter them when adding manually. Under the title you see the stock value (sum of known prices).
6. Recipes
- Optionally type a wish (e.g. "quick, no meat") and click Suggest recipes from inventory.
- The AI suggests 3–5 recipes; food that expires soon gets priority. Missing ingredients are marked with 🛒.
- 👍 / 👎 teaches the app what you like. ☆ Save adds the recipe to your planned ones (missing ingredients go on the shopping list).
- 🍽️ I cooked it uses up the ingredients from stock and records your habits.
- 🛒 Missing items to list adds ingredients you lack to the open shopping list (or creates a new "Manual list"); existing items are not duplicated.
- ⏱ Cooking time: pick 15, 30, 45 or 60 minutes (or type your own). Only recipes that are ready within that time are suggested; the default is "Max cooking minutes" from your settings.
Weekly meal plan
On the Recipes page click 📅 Weekly meal plan, choose the number of days (3–7) and meals per day (1–3), optionally add a wish and click Create plan. The AI first uses food that is about to expire, respects allergies and kitchen appliances and repeats ingredients across days. Each dish shows ✅ (you have it) or 🛒 (to buy); 🛒 Add to shopping list adds the missing ingredients to the open list. Recipes also show approximate nutrition per serving (kcal, protein, carbs, fat) – an estimate, not an exact calculation.
Nutrition and macros
- Every recipe and meal-plan meal shows a pie chart of how much energy comes from protein (blue), carbohydrates (orange) and fat (green), with grams and percentages.
- "I cooked it" or "I ate this" logs the meal in your food diary (1 serving).
- Nutrition today (Home): the day's combined chart, progress towards your daily goals and what you are still missing (e.g. 26 g protein, 42 g fat) with suggestions from your stock. Use the arrows for previous days; meals can be removed.
- Daily goals: the default is the adult reference intake (2000 kcal, 50 g protein, 260 g carbs, 70 g fat); change them on the Nutrition today page.
- Values are AI estimates and not medical advice.
- ⏱ Cooking time per meal: in the meal plan pick 15, 30, 45 or 60 minutes (or your own value). Meals that would take longer are marked ⚠.
7. Shopping list
- Enter how many days until your next shop and click Build personalised list.
- The list is sorted by priority (Urgent / Recommended / Optional) and each item says why it is there.
- In the store tick what you buy. At the end click Shopping done → to inventory: ticked items are added to stock.
8. How the app learns
Every event (added, consumed, discarded, cooked, bought) is recorded for the household. From this the app works out how often you buy each food, when you will run out and what share you throw away. After 2–4 weeks of use the shopping lists become very accurate. The home page shows the most important habits and the share of wasted food.
Insights: the Value of wasted food card shows how many euros went in the bin over the last 30 days compared with what was used, and which discarded items were the most expensive. Accuracy depends on the share of items with a price – scan receipts to make the data more precise.
For good learning: always mark items consumed/discarded and finish shopping through the list or a receipt scan.
9. Shared household
- In Me → Household you see the code (e.g. A1B2C3D4E5F6). A family member enters it when signing up or in the Join field.
- Members share stock, recipes, the shopping list and habits. Everyone has their own diet settings and their own AI quota.
- Kitchen appliances: tick what you have (stove, oven, microwave, air fryer, grill, blender, multicooker …). Recipes use only those appliances; without an oven you will not get oven bakes, and with an air fryer you get dishes for it.
- The owner can rename the household and change the code. Leave creates a new, empty household for you.
10. Notifications
Turn on the reminder in Me → Notifications. Every morning you get a push notification if any food expires today or tomorrow, with a link to recipes. Notifications are optional and can be switched off at any time. On iPhone they only work once the app has been added to the home screen (see 14).
11. Plans and Pro
The free plan has a limited number of AI calls per month (scans, recipes, lists). Pro has unlimited calls. Upgrade in Me → Plan; manage your subscription with the Manage subscription button (cancellation, invoices).
12. Forgot password
- On the sign-in screen click Forgot password? and enter your username or e-mail. If you have an e-mail address saved in Settings, you receive a reset link (valid for 1 hour).
- If e-mail reset is not available, an administrator sets a new password for you.
- You can change your password at any time in Me → Password.
13. Export and deleting data
- Export: in Me → Data and account click Export my data (JSON). You get a file with your profile (including the time of consent), household, inventory, events, recipes, shopping lists, AI calls (without image content) and activity log.
- Deleting the account: in the same section enter your password and click Delete account. Deletion is permanent and immediate. Shared stock, recipes and lists stay with the remaining household members; if you are the only member, the household is deleted. The only administrator must first assign the role to another user.
- Details are in the Privacy Policy and Terms of Use.
14. Installing on your phone
- iPhone (Safari): Share button → Add to Home Screen.
- Android (Chrome): menu ⋮ → Add to Home screen or Install app.
The app then opens standalone, with camera and notifications.
15. Administrator
An administrator sees an extra Admin tab:
- Users: search, plan (free/pro), role, setting a new password (🔑), disabling an account (⛔), AI usage.
- Activity log: all events by user and action type (sign-ins, scans, stock changes, purchases …).
- AI usage: every call with the model and token counts.
The first registered user and the user from the ADMIN_USERNAME setting automatically become administrators.
16. Troubleshooting
- "AI is not configured": the Anthropic API key is missing on the server (administrator).
- "Monthly quota used up": wait for the new month or upgrade to Pro.
- Photo will not upload: the maximum size is 8 MB; the app shrinks photos itself, so keep your browser up to date.
- Date not read: photograph closer, without glare, or enter the date manually.
- Notifications do not work: check the browser permission; on iPhone add the app to the home screen.