Shopping list from a nutrition plan

Basic Clients with an active program can generate a shopping list directly from their assigned nutrition plans - all ingredients for the chosen period, grouped by food category, with quantities calculated automatically.

How a client opens the list

Inside the mobile app, the client opens their Program and taps the cart icon in the header at the top of the screen. The cart only appears for programs that actually have a nutrition plan - the nutrition section switched on and at least one day with a nutrition template assigned - so a client never lands on an empty list. The list is read from their assigned nutrition templates for the period they choose. A back arrow at the top returns them to the program. The whole screen is shown in the client’s language.

Choosing a period

The client picks one of three period options:

Option	What it covers
This week	The current program week’s nutrition days. Once the program has finished, the list reports “This program has finished” rather than repeating the last week
Next week	The following program week (shown only if that phase is unlocked by the staged-rollout schedule)
Pick dates	A custom start and end date, chosen on a calendar. The calendar will not let the client select more than 28 days, and dates in a phase the staged-rollout schedule has not unlocked yet contribute nothing

How quantities are calculated

For This week and Next week, the app counts only the days that have at least one nutrition plan assigned (defined days). If fewer than 7 days are planned, quantities are scaled up so the result covers a full 7-day week:

A 2-day rotation -> multiplied by 3.5 (2 x 3.5 = 7).
A full 7-day plan -> multiplied by 1 (no change).
A note on the screen tells the client how many planned days the quantities were scaled from.

For Pick dates, every selected date is counted - there is no weekly scaling. Each date is matched to its day in the plan; if the plan defines only some days of the week (a training/rest rotation), those defined days repeat across the blank days so no selected day is skipped. A date that falls outside the program contributes nothing. Picking a full week this way therefore totals roughly the same as This week.

How quantities are shown

Quantities come from the measure the coach picked on the plan row itself, so the list always agrees with the plan the client is reading.
Foods the plan counts by the piece stay a count: eggs planned as 2 kom a day total 14 kom for the week, rounded up, rather than being converted to grams. This works in the unit the coach actually wrote - kom/komad, glavica, konzerva, kesica, Whole, medium and the like. If the same food is planned by the piece on one day and by weight on another, the list falls back to weight, since a count would be a guess.
Cooking portions - kašika, kašičica, šaka, kriška, cups, scoops, spoons - are converted to weight instead. You don’t buy a tablespoon; you buy the bottle, so grams is the useful number.
A row the coach named without an amount (a spice or garnish) shows as “as needed” rather than as 0 g.
Everything else is shown by weight in grams, rolling up to kilograms at 1 kg or more - e.g. 1.75 kg, 490 g. Cooking measures (cups, tablespoons, slices) are never used.
An item the plan lists without a measurable quantity shows as “as needed.” This is now rare - every plan row carries its own measures, however the food was added.
The same food is combined by name, so a food added one way on Monday and another way on Friday is one line on the list, not two.

“Choose one” meal groups

When a plan offers a choice - for example “Choose one breakfast” - the shopping list shows the whole group as its own block rather than mixing it into the category sections:

Choose one breakfast
  [ ] Eggs & Bacon: Brown Eggs 11 large + Bacon 490 g
      or Yogurt & Banana: Greek Yogurt 525 g + Banana 7 medium
      or Salmon bowl: Salmon 630 g + Broccoli 525 g

The default option (the first one) is the line the client ticks off, showing every ingredient in that option and its amount.
The other options are listed beneath, each prefixed with “or”, so the client sees what they can swap in.

Only the default option’s ingredients are counted toward the totals; the alternatives are for reference and are never summed. The same applies to any supplement inside a group: it is counted once, from the default option, not once per alternative.

Recipes inside a day

If the plan embeds recipes inside a day (or references a saved recipe), the shopping list flattens them into ingredients - the client sees the combined ingredient amounts to buy, not the recipe cards. When two recipes share an ingredient, it is summed into a single line (e.g. rice used in both a lunch and a dinner recipe appears once, as the total).

Ticking items off

The client can tap any food item to mark it done. Ticks are saved on the client’s phone (not synced to the server), so they survive closing and reopening the screen. Each combination of program, period, and device keeps its own ticks.

Exporting the list

The share icon in the header exports the list as plain text through the phone’s normal share sheet - so it can go to Notes, Messages, WhatsApp, email, or anywhere else the client shares to. It is deliberately text rather than a PDF: the point is a list someone can paste, edit, and read in a shop, and it works with no connection.

The export mirrors what is on screen - the period or date range, the scaling note, every category with its quantities, “choose one” groups with their swaps, and the supplements. Items already ticked off are exported as [x], so a list shared halfway round the shop still shows what is already in the basket.

Supplements

If the nutrition plan includes supplement entries, they appear in a separate Supplements section at the bottom of the list, showing the name, dosage, and total dose count for the period (e.g. Creatine - 5 g x 7). Supplements are informational, so they don’t have tick boxes.

Tip for coaches: if a client reports that the shopping list shows “no nutrition plans for this week,” check that their current program week has at least one nutrition template assigned to a day. A “no nutrition plans in that date range” message on Pick dates usually means the selected dates fall entirely outside the program’s start/end.