‹Recipe› Configuring Recipes

What is a recipe? The definition of a food or drink – with ingredients and quantities – so the app can calculate nutritional values.


When Is a Detailed Recipe Worth It?

Situation Recommendation
Breakfast you eat every day ✅ Create a full recipe
Favorite lunch ✅ Create a full recipe
Restaurant visit (one-off) 💡 A placeholder is enough
Holiday snack 💡 A placeholder is enough

Pareto principle: Put the effort into the 20% of meals that make up 80% of your diet. The rest can be logged as placeholders.


The 3 Recipe Types

‹Recipe› Full Recipe

All ingredients with quantities defined → nutritional analysis possible.

‹Placeholder› Placeholder

Only a name, no ingredients → logging possible, but no nutritional analysis.

‹Variant› Variant Recipe

A group of interchangeable ingredients – you choose the current variant when logging. Example: Coffee with milk → milk can be whole milk, oat milk or none.


Creating a New Recipe

Entry Point: Search

Recipes are accessible via two routes – with a slightly different view:

Settings → Recipes (management)

The recipe list has its own search field directly above the filter chips. Start typing and the filter chips update immediately with the match counts per category. The X button on the right clears the search text; the keyboard closes automatically when scrolling.

Tap a Meal tile (directly while logging)

When the search field is still empty, the app shows a prominent entry: fork icon, a short hint text and a large barcode button. As soon as you start typing, the view switches to the normal search results list with filter chips.

💡 The large barcode button in the empty state makes it particularly easy to start a scan directly – without having to search first.


Entering a name searches three sources simultaneously – visible via the counters in the filter chips:

Search view with results and create actions
Filter chip What it shows
All Everything combined
Recipes Your own saved recipes
Products Results from Open Food Facts (packaged products)
Ingredients Results from BLS (basic foods)

💡 The number in the chip shows how many results exist in that category. No result = chip grayed out.

Choose Creation Method

If no matching result is available, the app offers two direct actions (visible directly below the search field):

Option When to use
“Create recipe ‘…’” Enter ingredients right now
“Add ‘…’ as placeholder” No time now – complete later

Recipe Editor

After creating, the editor opens:

Recipe editor: empty state

Adding Ingredients

Enter the ingredient name in the editor’s search field. The filter chips show results per source again:

Ingredient search BLS (oats) Ingredient search OFF products (milk)

⏳ OFF search is limited to once every 10 seconds (Open Food Facts guideline). A brief wait is normal.

Step 2: Enter Quantity

After tapping an ingredient you enter quantity and unit:

Quantity input with unit picker

Switch units with the stepper on the right (g, ml, pieces, …). Then “Add”.

💡 Recipes can be nested to any depth: a recipe “Pasta Bolognese” can contain the recipe “Tomato sauce” as an ingredient.


Variants – Flexible Ingredients

Variants let you choose between multiple ingredients when logging – with the calorie impact shown per option.

Creating an Option Group

While adding an ingredient a button “Add as option…” appears at the bottom. Tap it instead of “Add”:

Quantity input with “Add as Option” button

The group creation dialog opens:

Dialog: create option group
Example: Coffee with milk
  Group "Milk types": UHT whole milk | Barista oat drink
  Selection required: NO → coffee also loggable without milk
  Multiple selection: NO → always only one milk type

Adding More Options

Find more ingredients via search and tap “Add as option…” again:

Searching for second variant (apple)

The app then shows all existing groups – select the right one:

Group selection: choose existing group

When Logging: Selecting a Variant

When logging a meal the full logging view appears:

Logging view with variant selection

Quick picker (top): Select common quantities with a tap (e.g. 200ml, 250ml, 330ml, 500ml). The slider below allows fine intermediate values.

Customize recipe (bottom): All variant groups of the recipe appear here with the available options. Next to each option is the calorie impact (e.g. +32 kcal for whole milk, +25 kcal for oat milk). Tap an option to select it.

The pre-selection is remembered for the next logging – you only need to change it when you’re having something different.


Recipe with Many Ingredients: Pasta Example

Recipes with multiple ingredients look like this in the editor:

Recipe editor: oats + Fruits variant group

Each ingredient shows calories per 100g as reference. The serving size determines how much counts as “one serving”.


BLS Linking for OFF Products

OFF products (scanned products) often only contain macronutrients (energy, protein, fat, carbohydrates). For a complete micronutrient analysis (vitamins, minerals, amino acids) the app links each product ingredient to a BLS entry.

This happens partly automatically – you can see the progress in the product detail view:

BLS links overview

Color coding of links:

Color Meaning
🟦 Blue – “Manually linked” You confirmed the link yourself
🟧 Orange – “Automatic (uncertain)” App linked it, but percentage below 70% – please check
✅ Green – “Automatic (safe)” Link with high similarity
⬜ Gray – “Not yet linked” Ingredient couldn’t be matched

The percentage shows the similarity between product ingredient and BLS entry.

Tap an ingredient → the app shows suggestions with similarity scores:

BLS link manual

You can switch between Auto-linking (AI suggestions sorted by similarity) and BLS search (free text search). Tap the desired entry to apply it.

💡 Links are optional, but they significantly improve the quality of the analysis.

→ More on the difference between BLS and OFF: Data sources


Nutrition Report

If you log meals regularly, you can open the Nutrition Report under Reports. It shows average daily intake for a selectable time period – with a quality rating showing how reliable the data basis is.

Data quality: The app rates how complete your entries are and whether nutritional values come from precise (BLS/OFF linked) or estimated (placeholder) sources.


Completing a Placeholder Later

  1. Settings → Recipes
  2. Find the placeholder in the list
  3. Tap → add ingredients → “Done”

All previous events with this placeholder are automatically linked to the new nutritional data.


Frequently Asked Questions

Can I create a recipe directly while logging? Yes. When tapping a meal tile on the dashboard you can enter a new name and create it immediately as a placeholder or full recipe – without going to Settings first.

Can recipes be exported or shared? Yes. In the recipe list (Settings → Recipes) there is an Import/Export symbol at the top right. Use it to export individual or all recipes as a .ioom file. An optional toggle “Include photos” (active by default) embeds associated nutrition photos as Base64 in the file, so they’re immediately available when importing on another device. The exported file can be shared via AirDrop, Mail or iCloud.

What’s the difference between BLS and OFF? BLS is a scientific nutrient database for basic foods (raw ingredients). OFF is a crowdsourced database for packaged products (barcode scan). → Data sources explained