User Guide

Reference documentation for every feature

Guide navigation

Food Diary

The Food Diary helps you track daily meals and nutrition. Log what you eat, monitor macronutrients, and work toward your nutrition goals.

Enabling the Food Diary

The Food Diary is an optional feature. Enable it from Settings → Food Diary by toggling the feature on. Once enabled, it will appear in the Organisation section of the sidebar.

Logging Meals

  • Navigate to the Food Diary page from the sidebar
  • Use the date navigator to select a date
  • Add a meal entry (Breakfast, Lunch, Dinner, or Snack) and then add individual food items to that meal
  • Each food item can include name, quantity, and nutrition data (calories, protein, carbs, fat)
  • Sort entries by time, calories, or meal using the sort dropdown

Custom Meal Names

The default meal names (Breakfast, Lunch, Dinner, Snack) can be customised in Settings → Food Diary. Rename them to match your eating patterns — for example, "Morning Tea" instead of "Snack" or "Brunch" instead of "Breakfast". Your custom names appear throughout the diary and quick capture.

Nutrition Lookup

The Food Diary integrates with two free nutrition databases:

  • Open Food Facts — free, no API key required. Search by name or barcode.
  • USDA FoodData Central — comprehensive US nutrition database. Requires a free API key (register at fdc.nal.usda.gov).

Configure your preferred source in Food Diary settings.

AI Gap-Fill Estimates

Use the AI Estimate action when logging a meal item to fill serving size and macro gaps. The system checks configured nutrition sources first (Open Food Facts / USDA), then falls back to AI estimation if no reliable match exists.

Quick Capture food logs follow the same order: database first, AI fallback.

Favorites

Save frequently eaten foods as favorites for quick re-entry. Click the heart icon on any food item to save it, then use "From favorites" to quickly add it to future meals.

Daily Summary

The nutrition summary at the top of the page shows your daily totals for calories, protein, carbs, and fat. If you set nutrition goals in settings, progress toward those goals is displayed alongside the totals.

Recipe Integration

Link meals to your recipe notes. When you log a recipe, its ingredients are automatically imported as food items with nutrition data looked up from the configured sources.

Shopping List Integration

Generate a shopping list from your food diary entries for a date range. The system aggregates food items and suggests shopping items that you can add to your Shopping List.

Quick Capture Integration

  • /fd avocado toast logs directly to Food Diary
  • /food buddha bowl with eggs logs with nutrition assist
  • I ate salmon and rice for dinner can be detected as a food log