Plan builders

templates/
├── page.tsx                    list page, ?scope=training or ?scope=nutrition
├── TrainingProgramsView.tsx    template list, folders, exercise library entry
├── NutritionProgramsView.tsx   template list, folders, food library
├── actions.ts                  templates, folders, libraries, import, PDF upload
├── CreatePdfPlanDialog.tsx, pdf-template-actions.tsx, media-upload.ts
├── FolderColorPicker.tsx, use-template-list-assign.ts
├── [id]/edit/page.tsx          template editor
├── builder/                    both builders and everything they render
└── import/                     the AI import wizard

​

Routes

​

What the editor page loads

1. Load the plan (/program-templates/{id} or /programs/{id}). A 404 becomes notFound().
2. For a trainee program, check program.clientId === clientId. A mismatch is notFound().
3. If isFilePlan(plan), render PdfPlanPage and stop. See below.
4. Load the whole library: /foods with pageSize: 5000 or /exercises with pageSize: 2000.
5. Normalize the content with normalizeNutritionContent or normalizeTrainingContent.
6. Call withMissingById(items, ids, loadOne) from modules/shared/lib/plan-library-refs.ts. If the plan references a library item that the list did not return, it is fetched one by one. A plan must never render a row whose exercise or food is unknown.
7. Render NutritionBuilder or ProgramBuilder.

​

File plans

​

Training content

export interface TrainingContent {
	schemaVersion: 2;
	meta: TrainingMeta;
	days: TrainingDay[];
}

export interface TrainingDay {
	id: string;
	label: string;
	strength: StrengthRow[];
	cardioMinutes: string;
	stepsDaily: string;
}

​

Nutrition content

export interface NutritionContent {
	schemaVersion: 1;
	meta: NutritionMeta;
	days: NutritionDay[];
}

export interface NutritionDay {
	id: string;
	label: string;
	targets: NutritionTargets;
	meals: NutritionMeal[];
}

• Targets are per day: kcal, protein, carbs, fat, water, and optional portion targets mbpProtein, mbpCarb, mbpFat. kcalOverride is set once the coach types a calorie target over the one derived from portions.
• A NutritionMeal has a type (breakfast, snack_am, lunch, pre, post, dinner), an optional custom label, time, prep, items and an optional target (MealTarget).
• A MealItem has foodId, qty, note, alts (substitutes) and an optional countsAs of protein or carb.
• NutritionMeta carries goal, autoAlts, and the import flags imported, source, draft and goalSet.

​

The training builder

​

Auto-fill

• liveFill(rows, sourceId, field, value, owners) writes the source cell, then updates every other row that may follow it.
• A row follows when its cell is empty, or when the cell is still owned by that same source. A cell the coach typed in themselves is never overwritten.
• Rest is never filled into a superset partner. Reps are only copied between rows with the same repType.
• Typing in a cell releases its ownership (releaseFill).
• appendWithBaseline makes newly added exercises inherit sets, rest and reps from the first non superset row, and marks them as owned by it so later edits to the first row keep flowing down. Reps are not copied when the first row’s rep type is minutes.

​

The nutrition builder

​

Saving and exiting

​

Assigning a template

​

Folders

​

The import wizard

​

Tests worth reading first