Shopping Lists

Shopping Lists

Shopping lists are one of the core modules in FamilyHub. All family members share the same lists in real time — the moment someone adds an item or checks it off, every connected device updates instantly.

A shopping list with items grouped by category — dairy, fruit and vegetables, meat and fish, bakery — with one item already checked off.

Multiple Lists

The shopping-lists overview page.

You start with no lists — create one for each shopping trip or store:

  • IKEA — furniture and home accessories
  • Gamma — hardware and DIY supplies
  • Action — household and discount items

To create a list: tap + on the Shopping Lists screen, give it a name, and optionally choose an icon. Lists can be archived (hidden from the main view) when no longer needed. List names are unique within your family.

Adding Items

There are three ways to add items to a list:

  1. Tap + on the list — type the item name, optional quantity and unit
  2. AI text input — type "voeg melk, eieren en brood toe" in the AI bar
  3. AI voice input — tap the mic and say it out loud

The AI automatically assigns items to the correct category based on their name. You can override the category manually after adding.

Item Categories

Items are grouped by category within the list to make in-store navigation easier:

CategoryDutch nameExamples
DairyZuivelMelk, kaas, yoghurt, boter
Fruit & VegetablesGroente & FruitAppels, broccoli, wortels
Meat & FishVlees & VisKip, zalm, gehakt
Bread & BakeryBrood & BakkerijBrood, broodjes, croissants
DrinksDrankenSap, water, bier, wijn
HouseholdHuishoudenSchoonmaakmiddel, keukenpapier
FrozenDiepvriesPizza, ijsjes, diepvriesgroenten
Canned GoodsConservenBlikken soep, tomaten, bonen
Sauces & SpicesSauzen & KruidenKetchup, mayonaise, peper
SnacksSnacksChips, koekjes, noten
Personal CareVerzorgingShampoo, tandpasta, zeep
OtherOverigEverything that doesn't fit above

Checking and Unchecking Items

Tap an item to check it off — it moves to the bottom of its category group with a strikethrough. Tap again to uncheck it. Swipe an item left to remove it.

All changes are reflected on every connected device within one second.

Clearing Items

After finishing a shopping trip:

  • Clear checked items — removes everything that was checked off. Unchecked items remain.
  • Clear all items — removes every item from the list.

Auto-Categorization

FamilyHub uses AI to automatically categorize items based on their name. A background job runs periodically (configurable by your family admin — default every hour) to categorize any items that haven't been categorized yet. You can also trigger categorization manually from the list view.

Real-Time Sync

Shopping lists use WebSocket for real-time updates. When you're in the supermarket and your partner adds an item from home, it appears on your screen immediately — no need to refresh or reopen the list.

AI Commands

CommandAction
"voeg melk toe"Adds milk to your default list
"voeg melk, eieren en brood toe"Adds multiple items at once
"voeg Billy kast toe aan de IKEA lijst"Adds to the IKEA list
"heb ik al boter op de lijst?"Checks if butter is on the list
"kruis boter af"Marks butter as checked
"zet melk terug"Unchecks milk
"verwijder boter van de lijst"Removes butter permanently
"verwijder alle afgevinkte items"Clears checked items
"voeg een IKEA lijst toe"Creates a new list named IKEA
"verwijder de IKEA lijst"Deletes the IKEA list