⚡ USDA Foundation Foods Batch Processor

Download CSV zips from fdc.nal.usda.gov/download-datasets (Foundation Foods CSV).
Mira boot checks twice a year (01/01 and 06/01 — American dates) if a newer release than 04/30/2026 exists; downloads to Archive/nutrition_heavy/usda_downloads/ when needed.
Joins locally — no API calls, no rate limits — averages all samples of the same food description, then pushes clean entries to Firestore master_foods.
Required: food.csv + food_nutrient.csv + nutrient.csv  |  Optional: food_portion.csv (adds cup measurements)

🏷️ FDC Branded Foods Importer — with Barcode (gtinUpc)

Upload branded_food.csv from the Branded Foods CSV download at fdc.nal.usda.gov/download-datasets.
Also requires food.csv and food_nutrient.csv from the same download.
Extracts gtinUpc barcode, brand name, and macros. Pushes to master_foods with _source: USDA_Branded.

📦 Export Two-Tier Food JSON

Exports master_foods from Firestore into two compressed JSON files for embedding in Victis Light.
Macro JSON — calories, protein, carbs, fat, fiber, sugar, sodium — embedded in app at build time, works offline forever.
Micro JSON — 14 mineral and vitamin fields — optional pull, cached in localStorage after first download.

How to embed in Victis Light:

1. Download both JSON files

2. Place victis_foods_macro.json in D:\Firestorm-Scripts\

3. Place victis_foods_micro.json in D:\Firestorm-Scripts\

4. The build script reads macro JSON and embeds it as a base64 string in the Light shell

5. Micro JSON is uploaded to Firebase Storage — Light pulls it once on demand

📧 Play Store launch list

Signups from victis.systems are stored in R2 and sent through Cloudflare Email Service (not Brevo).
Dry-run first to see how many people match a tag, then send the launch email when you are ready.