‹ App
FridgeAI – guide

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

  1. 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.
  2. If you are joining a family that already uses the app, also enter the household code (the owner finds it in Settings).
  3. In the Me tab enter allergies, diet and household size. All recipes and lists take these into account.
  4. 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).
  5. 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

  1. 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).
  2. Within seconds the AI lists the food with quantity, category and an estimated shelf life.
  3. 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.
  4. 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.

  1. Scan → Expiry. Optionally type the name of the food (it helps matching with your stock).
  2. The AI reads the date and its type (use by or best before).
  3. 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.

  1. 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.
  2. 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.
  3. 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

6. Recipes

  1. Optionally type a wish (e.g. "quick, no meat") and click Suggest recipes from inventory.
  2. The AI suggests 3–5 recipes; food that expires soon gets priority. Missing ingredients are marked with 🛒.
  3. 👍 / 👎 teaches the app what you like. ☆ Save adds the recipe to your planned ones (missing ingredients go on the shopping list).
  4. 🍽️ I cooked it uses up the ingredients from stock and records your habits.
  5. 🛒 Missing items to list adds ingredients you lack to the open shopping list (or creates a new "Manual list"); existing items are not duplicated.
  6. ⏱ 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

7. Shopping list

  1. Enter how many days until your next shop and click Build personalised list.
  2. The list is sorted by priority (Urgent / Recommended / Optional) and each item says why it is there.
  3. 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

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

  1. 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).
  2. If e-mail reset is not available, an administrator sets a new password for you.
  3. You can change your password at any time in Me → Password.

13. Export and deleting data

14. Installing on your phone

The app then opens standalone, with camera and notifications.

15. Administrator

An administrator sees an extra Admin tab:

The first registered user and the user from the ADMIN_USERNAME setting automatically become administrators.

16. Troubleshooting