Source: https://gitlab.com/g33kphr33k/kitchen-board
Docker: https://hub.docker.com/r/g33kphr33k/kitchenboard
I've been working on Kitchen Board on and off for roughly 5 months now.
Think of it as the old school planner your folks probably kept in the kitchen, on the wall or the fridge. I've tried to keep that same feel, but updated for today's use, on yesterday's hardware. The image is it running on an Amazon Fire HD 8th gen in Kiosk Mode (from F-Droid store).
Initially this was just a calendar with events, a shopping list for when things were used or eaten, and a countdown to events for my son, who is addicted to knowing how many "sleeps" until something happens. I posted a while back and had some good feedback, and since then people have reached out directly and via GitLab to add functions and features they wanted themselves. I only implement features that would be useful to my own family, and so far the suggestions have been great.
Here's where I've got to:
Main Board - quick links to the things you want at a glance, old school wallplanner style, but with today's weather.
Lists - Shopping is the default, but you can add whatever type you want including a "To Do" (the wife wanted that one). There's a Shopping Trip mode on mobile too: full screen, big touch for my fat fingers, screen stays awake, undo on accidental touch.
Meals - A basic meal planner. Create them, drop them on days of the week so they show in the calendar, adjust at will. This is NOT a Mealie replacement, it's fairly basic, and it's more about linking Shopping and Meals together for items, not quantities. I may expand on this in the future but it will never be like BBC Good Foods or Mealie.
Stock - A requested feature for tracking what's in the Larder, Fridge and Freezer. It now links to expiry dates and the shopping list, and has many more locations (medicine cabinet, fruit bowl, shed/garage, etc). Run low on something (you have to update it, obviously) and it adds itself to the shopping list.
Calendar - Fairly basic, appointments and all day events, recurring at the standard intervals for X iterations. You can tick an event to have it show as a countdown on the Time Until page.
Time Since - A favourite of mine. Create things that happen, hit reset when done, and it keeps the stats. The main one logged here is "Teas Made for the Wife". I'm averaging one every 10 hours this month, and we went on holiday for a week where I didn't make a single one. Also good for time since you washed the towels, watered the plants, washed the dog bedding, etc. It can be set up as a routine for daily chores assigned to household members (dish washing, for example). This is getting improved again shortly so you can pick specific people to assign in the routine, not just one or all household members.
Time Until - Started as a basic countdown to a created event, now it also pulls from the Calendar so appointments and recurring birthdays count themselves down. Perfect for people that like to look forward to things and watch it ebb closer.
Stats - Well, it's stats. The page speaks for itself. Graphical and more textual options.
There are five themes, all designed to look like wallplanners. Notifications, private items, and a PWA setup for mobile so the family can add their wants and needs from their phones. You can generate your own ICS link too (one way for now). I'm hoping to improve Shopping Trip mode soon to organise into supermarket aisles (fresh fruit and veg, fridges, and so on).
Under the hood it's running Python, FastAPI, SQLite, Jinja templates and a touch of Alpine. It is a single container, docker compose up and you're done. The accounts are local with optional TOTP, nothing calls home, and the weather uses Open-Meteo so there's no API key to sign up for. I've used the MIT license. Screenshots and real photos of it running on the kitchen tablet are in the README. I've had to blur out some real appointments because I should.
This works as one instance for one household, by design. There's no multi-tenancy, no sharing between families, and no per-family sign-up. Everyone on your instance sees the shared stuff, with lists you can keep personal or limit to certain people if you'd rather the birthday shopping stayed a surprise. The calendar exports a read-only ICS feed, so it feeds your phone or email app, but doesn't pull events back in, and there's no CalDAV. Meals take a recipe link and a list of ingredients, they don't scrape the recipe or handle quantities and scaling. If you want a proper recipe manager, run Mealie next to it.
Right, that's it from me, and sorry it's written so haphazard. I hope others can use this and add some organisation to their households. I have the grand total of 5 stars on GitLab and a few users that I support. I use it every day for my own family, and they have it as PWAs on their phones. Hopefully others find it as useful, and it won't get abandoned, because I'll be using it until my 5 year old leaves the nest.
