← All work
Home Meal Planner icon: a house with a spoon and fork
CASE STUDY · HOME ASSISTANT · OPEN SOURCE

Home Meal Planner

It plans the week’s dinners, writes the shopping list and rings a dinner bell for the whole household. It runs on the house’s own Home Assistant, and anyone at home can change the plan from their phone.

The kitchen display showing Tuesday’s dinner, pasta bake and salad, with the cook, the time, a Dinner time button and the rest of the week underneath
The Week on a phone: Monday’s spaghetti bolognese with nutrition, who is eating and who is cooking
The same week on the kitchen display and on a phone. Each person can choose their own theme and accent colour.
46
meals in our family library
15
weeks planned so far
0
front-end dependencies or build steps
1
file to back up everything
THE IDEA

Dinner is a household job, so the plan lives in the household’s hub

Most meal apps are built for one person on one phone, whereas this one is built for a whole household. The plan is shared, anyone can change it, and every screen updates by itself, from phones to the kitchen display.

It runs as a Home Assistant app, so there are no accounts or subscriptions and nothing leaves the house. Installed on a phone, it keeps a read-only copy of the week for when you’re out.

What it does

THE WEEK
Today first, at a glance

Shows each day’s meal, who’s eating and who’s cooking, and moves on to tomorrow once dinner’s done. Tap a meal’s photo to flip it over and see the ingredients, scaled to the number of people eating.

PLAN
Plan the week in a minute

Pick from the library for each day, copy last week’s plan, or clear the week and start again.

SHOPPING
A list that writes itself

Lists the week’s ingredients, scaled to the servings, with an “Also needed” list for things like foil, baking paper and birthday cards. You can share or print it.

MEALS
The family recipe book

Each meal has photos, links, tags, ingredients and nutrition per serving. Everyone can rate meals, so you can sort by whose taste counts tonight.

The Week: Monday’s meal with nutrition, who is eating and who is cooking
The Week
A meal card flipped over to show its ingredients for 4 people
Flip a meal to see its ingredients
The shopping list for the week, with 17 items to buy
The week’s shopping list
The meal library, with 46 saved meals, tags, nutrition and ratings
The meal library and ratings
The appearance panel in dark mode, with a choice of twelve accent colours
Each device picks its own look
AROUND THE HOUSE

A kitchen display and a dinner bell

Kitchen display

Casts the week to a Google Cast screen during the hours you choose, only when nothing else is using it, and dims overnight.

Dinner bell

Rings on the speakers you pick, so nobody has to shout up the stairs, and there’s a “Dinner time!” button on the kitchen display.

The kitchen display flipped to show the ingredients for pasta bake and salad for 2 people
Tap the meal for its ingredients
The kitchen display in its light theme
The display’s light theme

The display shows the time, today’s meal and cook, and the rest of the week along the bottom, with a shopping tile that opens the list. You choose when it moves on to the next day.

HUMAN CALLS

Small decisions that make it pleasant to live with

Tabs at the bottom on a phone

The top of a phone screen is the hardest place to reach, so on a phone the tabs sit at the bottom.

Built for one-handed shopping

The tick-off bar sits where your thumb is when your other hand is on the trolley.

A bell that never rings by itself

Cast can’t resume whatever a speaker was playing before the bell, so it only rings when someone presses it.

A restore you can undo

Restoring a backup saves a copy of what was there first, which makes it safe to reinstall the app.

OPEN SOURCE

Free to use and change

It’s in a public repository of Home Assistant apps, so other families can install it and other developers can see how it was built.

Python 3.12 server Plain JavaScript Installable web app Google Cast Home Assistant Built with Claude
INSTALL
1. In Home Assistant, add github.com/petebond/homeassistant-apps as a repository in the app store.
2. Install Meal Planner and start it.
3. Open it from the sidebar, then add your household and your first meals.

If you’d like something like this for your home or your team, I’d be glad to talk it through.

Send me a message
← Droppl All work →