HEB Meal Planner — plan your week in H-E-B's language

What it does

Built for families who already shop at H-E-B — not another generic recipe app.

🍽️

56 recipes, 10 cuisines

Mediterranean, Mexican, Tex-Mex, Italian, Asian, Indian, American, Southern, Cajun, breakfast.

🎯

Anchor meals

Lock in your go-to dinners; the week auto-fills around them.

🏷️

Brand intelligence

skirt steak → Mi Tienda Fajitas. feta → Central Market.

🧾

Consolidated list

2 limes + 3 limes = 5, grouped by store department, deep-linked to heb.com.

💵

Budget mode

"I want to spend $X" and the plan fits, with estimated costs.

🎟️

Weekly coupons

Deals that match your list, with estimated savings.

🥗

Diet & protein filters

Vegetarian, vegan, gluten-free, pescatarian, or "chicken only."

🚚

Pickup or delivery

Choose how you want the order fulfilled.

🌙

Dark mode

Because of course.

🔒 Privacy by design: the "buy" step is a deep link your own browser follows to heb.com. The app never scrapes or automates H-E-B from its servers.

Run it in one command

The whole stack — web, API, and Postgres — via Docker Compose.

git clone https://github.com/jordanistan/heb-meal-planner.git
cd heb-meal-planner
docker compose up -d --build

Open localhost:3000 — the app.
Pick a diet/protein, cuisines, and your anchor meals.
Set a budget (optional) and hit Generate plan.
Tap Find → on any item to open it on heb.com.

Prefer no Docker? See the local dev steps. Want AI-generated cooking steps? Add an ANTHROPIC_API_KEY.

Roadmap

Where it's headed.

🤖 Pro: assisted cart-fill

Your API key + Claude's browser extension load your cart on heb.com — stopping before payment.

💲 Real prices & coupons

Live catalog and weekly-ad data via a partner feed.

🛒 Multi-retailer

Beyond H-E-B over time.

Plan your week in H-E-B's language.