No description
Find a file
Dunemask 39ab01d89e [FEATURE] add README demo recording, fix planner chip layout
Playwright's Electron driver walks the app through planner, shopping, recipes,
catalog and settings against a throwaway --user-data-dir, so no real plan data
appears. Output ships as a 3.3 MB GIF for inline README rendering plus a 728 KB
h264 copy for full quality.

Recording surfaced a layout bug: with the cook-time badge and the people stepper
on the same row as the meal name, a 7-column week squeezed the name to zero
width and chips showed only a duration. The name now owns its own row and the
controls sit beneath it.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-03 07:42:03 -06:00
docs [FEATURE] add README demo recording, fix planner chip layout 2026-08-03 07:42:03 -06:00
scripts [FEATURE] add README demo recording, fix planner chip layout 2026-08-03 07:42:03 -06:00
src [FEATURE] add README demo recording, fix planner chip layout 2026-08-03 07:42:03 -06:00
.gitignore [FEATURE] initial commit — Ambrosia local-first meal planner 2026-08-03 07:28:55 -06:00
bun.lock [FEATURE] add README demo recording, fix planner chip layout 2026-08-03 07:42:03 -06:00
electron-builder.yml [FEATURE] initial commit — Ambrosia local-first meal planner 2026-08-03 07:28:55 -06:00
package.json [FEATURE] add README demo recording, fix planner chip layout 2026-08-03 07:42:03 -06:00
README.md [FEATURE] add README demo recording, fix planner chip layout 2026-08-03 07:42:03 -06:00
tsconfig.json [FEATURE] initial commit — Ambrosia local-first meal planner 2026-08-03 07:28:55 -06:00
tsup.config.ts [FEATURE] initial commit — Ambrosia local-first meal planner 2026-08-03 07:28:55 -06:00
vite.config.ts [FEATURE] initial commit — Ambrosia local-first meal planner 2026-08-03 07:28:55 -06:00

Ambrosia

Local-first meal planner — plan a week of meals, keep a library of healthy veg-forward recipes, generate aisle-grouped shopping lists, and jump to grocery buy links. Electron + Bun + React + Chakra UI v3. All data is plain JSON on disk.

Ambrosia walkthrough

Planning a week, checking a meal's time and ingredients, prep tasks, a generated shopping list, the recipe library, the food catalog, and settings. Full-quality MP4 · regenerate with node scripts/demo-video.mjs.

Features

  • Weekly planner — 7-day × breakfast/lunch/dinner/snack grid. Drop in saved recipes or quick notes; navigate weeks; one click builds a shopping list.
  • Recipes — save, favorite, categorize, tag, search. Full editor with ingredients, steps, and per-serving nutrition. Ships with 52 default recipes (vegetable-forward, small meat portions).
  • AI template — a button emits a JSON recipe skeleton to hand to any AI assistant; paste the filled result back to import it as a real recipe.
  • Food catalog225 seeded ingredients across 14 categories (vegetable-heavy), searchable, with custom adds.
  • Shopping lists — auto-aggregated + deduped from a week's recipes, grouped by grocery aisle, checkable, with a "where to buy" lookup.
  • Buy links — per-item deep search links to Instacart / Walmart / Kroger / Target / Amazon Fresh / Whole Foods / Google Shopping, plus live Open Food Facts product matches (free, no API key).

Run

bun install
bun run dev      # build + launch Electron

Other scripts: bun run tsc (type-check), bun run build, bun run dist (package via electron-builder).

Storage

JSON files under Electron's userData dir (dev: a dev/ subfolder): recipes.json, foods.json, plans.json, lists.json, settings.json, plus an assets/ folder for imported photos. Back them up or hand-edit freely — the app watches and reloads on external edits.

Documentation

Full docs live in docs/: