cook.md

Check a Meal Plan Against Daily Nutrient TargetsCook Basic & Pro

Calories are easy to count. Whether a week of dinners gives you enough fibre, iron, calcium or vitamin D is not. Core Vitals, a plugin for Cook Editor, adds up every ingredient in a meal plan and scores it against 17 daily targets, so you can see what the plan is short of before you shop for it.

Core Vitals report for a three-day meal plan for two people: 7 of 17 targets met, energy at 117 % of target, the macro split, and each nutrient as a share of its daily value with fibre, calcium, vitamin A, vitamin D and folate below target

Where you'll end up: a three-day plan for two people, scored nutrient by nutrient.

What you need

  • Cook Editor, a free desktop app for macOS, Windows and Linux.
  • The Core Vitals plugin, free from the editor's Extensions view.
  • To be signed in with Cook Basic or Cook Pro. The numbers come from Cook's nutrition database, which is part of both plans. New accounts can try Cook Basic free for 7 days: see pricing.

1. Install Cook Editor and Core Vitals

Download Cook Editor and open the folder where you keep your recipes (installation help). Recipes are plain .cook text files, so the folder stays yours whatever you use to open it.

Open the Extensions view from the activity bar on the left, search for Core Vitals and click Install. It is active straight away. Sign in to your Cook account in the editor so the plugin can use the nutrition data.

2. Write the plan

A meal plan is a .menu file: days, meals, and the recipes or loose ingredients in each. The servings line at the top is the number of people eating, and each ==Day== heading counts as one day.

---
servings: 2
---

==Day 1==

Breakfast: \
- @./Breakfast/Easy Pancakes{} with @maple syrup{2%tbsp}

Dinner: \
- @./Risotto{} \
- @green salad{1%bowl}

==Day 2==

Breakfast: \
- @oats{1%cup} with @milk{1/2%cup}

Dinner: \
- @./Neapolitan Pizza{}

@./Risotto{} points at a recipe file in the same folder, and its ingredients are pulled in. A single recipe works too, without a plan: Core Vitals then judges one serving against one meal.

3. Read the badge

Open the plan or a recipe in the preview. A pill such as Vitals 6/17 appears in the header: the number of targets met, for the days and people the plan covers. It is green from 90 % of targets met, amber from 60 %, red below. Hover it to see what is below target or over a limit.

A recipe preview for Easy Pancakes with a Vitals 6/17 badge; its hover lists energy, fibre, calcium, iron, potassium, magnesium, zinc and vitamin A as below target for one serving

One serving of pancakes as one meal of the day: 6 of 17 targets met, and the hover says which fall short.

Vitals ? means there is not enough to go on: fewer than 70 % of the ingredients were found in the nutrition database, or a recipe the plan points at is missing. The hover says which.

4. Open the report

Click the heartbeat icon next to the shopping-list cart. The report shows:

  • Targets met and energy against the target for the whole plan.
  • The macro split: protein, carbohydrate and fat as shares of energy, against the recommended ranges.
  • Every nutrient as a share of its daily value: fibre, saturated fat and sodium (as limits), calcium, iron, potassium, magnesium, zinc, and vitamins A, C, D, B12 and folate.
  • Energy per day, for plans of more than one day.
  • What could not be checked, and how many ingredients were matched.

From there the fix is in the plan itself: swap a dinner, add a side, and click the heartbeat again to see what moved.

5. Set your own targets

The defaults are generic adult daily values. Change them under Settings → Extensions → Core Vitals:

  • Standard: FDA (default), EU or UK daily-value tables.
  • Energy: your own daily kcal target.
  • Protein, carbohydrate, fat: fixed shares of energy, or leave them at 0 for the recommended ranges.
  • Micronutrients: which ones are checked as minimums.
  • Tolerance: how far from a target still counts as met.
  • Meals per day: what share of a day one recipe serving stands for.

The badge follows a change at once. An open report keeps the targets it was opened with, so click the heartbeat icon again to refresh it.

What it can't tell you

  • Daily values are generic adult figures, not personal medical advice.
  • The totals are estimates from ingredient names, amounts and units. An ingredient the database can't match is left out, and the report says how many were matched.
  • Name ingredients plainly and give them a weight or volume (@rice{200%g}, not @rice{1%bag}) and more of the plan is counted.
  • In the current Cook Editor, editing a .menu file does not refresh an open badge or report by itself. Add "files.associations": { "*.menu": "cooklang" } to your settings as a workaround.

Where to go next