Free · open source · self-hosted

The shopping list for the whole house.
Made for the supermarket aisle.

One list shared by everyone at home, sorted in the order you walk each supermarket. Tick things off with one thumb, keep going with no signal, and see what you spend and what's about to run out.

  • Works offline
  • One-handed
  • Learns your habits
  • No tracking
  • English · Español

Live demo with made-up data. Add "milk x2, bread", swipe items to the cart, finish the shopping, create a store… Nothing is saved.

Open full screen ↗

Everything for the weekly shop, nothing else

By aisle and by store

The list sorts itself in the order you walk the supermarket. Add your own stores, each with its tab.

Swipe to the cart

Tap or swipe right to tick, left to delete, long-press to edit. Every action can be undone.

Add in seconds

"milk x2, bread, eggs x12" in one go, suggestions as you type, your usual items one tap away, and new items with their aisle.

Works with no signal

Changes show instantly, stay on the phone and are sent when the connection comes back.

Shared at home

Everyone sees the same list within seconds, on their phones and on a tablet dashboard in the kitchen.

History and receipts

"Shopping done" saves the trip with the amount and a photo of the receipt. Repeat any past trip.

About to run out

It learns how often you buy each thing and suggests it when it's due again.

Stats and templates

Spend per month and store, how often you shop, what you buy most, and templates for the lists you repeat.

List sorted by aisle with a progress bar Adding a new item and choosing its aisle Spending stats per month and store Dark mode

Your list, on your server

This isn't a service you sign up for: each household runs its own copy. No account, no ads, no analytics.

Install yours

One Docker container (web app + API) next to PostgreSQL. At home, on a NAS, a Raspberry Pi or a VPS.

  1. Download and buildgit clone https://github.com/davidniin/grocery-list.git
    cd grocery-list && docker build -t grocery-list .
  2. Connect it to PostgreSQLSet DATABASE_URL and a long GROCERY_TOKEN (or Cloudflare Access). The database schema is created on start.
  3. Add HTTPS and open it on your phoneWith Cloudflare Tunnel, Caddy or Tailscale. Then "Add to Home Screen".

Open source, open to ideas

Found a bug or have an idea? Issues and pull requests are welcome, in English or Spanish: translations, your supermarket's aisles, new features…

View on GitHub

Support the project

This app is free and always will be. If it's useful to you, you can buy me a coffee to keep it going.

Buy me a coffee