Bentomo Shopping

Free shopping list for the whole family
A fast, simple, and collaborative app for managing your grocery lists

Bentomo Shopping is a lightweight web application for managing shopping lists, designed for families and households. It enables real-time synchronization across multiple devices so that everyone — from a partner to the kids — knows what to buy and what is already in the cart.

The app runs in any modern browser on mobile and desktop. It requires just one password to log in — no complicated registration or accounts needed.

This project is a community fork of Koffan (by PanSalut), rebranded and extended under the Bentomo family of tools.

We needed an app that would let the whole family create a shopping list together and get groceries done quickly. After testing various solutions, none were simple and fast enough for our workflow — so we forked and improved one that was close.

The app is written in Go and uses just ~2.5 MB RAM at runtime, making it ideal for self-hosting alongside other services.

• Ultra-lightweight — ~16 MB on disk, ~2.5 MB RAM
• Multiple lists — Create separate lists for different stores or occasions, each with a custom icon
• PWA — Install on your phone home screen like a native app
• Offline mode — Add, edit, check, and uncheck items without internet (auto-sync when reconnected)
• Real-time sync — WebSocket-based live updates across all connected devices
• Auto-completion — Fuzzy search from your history, remembers sections
• Organized sections — Group products into categories (e.g., Produce, Dairy, Cleaning)
• Quantity stepper — Adjust amounts quickly with +/- buttons
• Mark as purchased — Check off items as you shop
• Mark as uncertain — Flag items you cannot find in the store
• Responsive UI — Mobile-first design, works great on tablets and desktops
• Dark mode — Respects system preferences with manual override
• Multi-language — English, Spanish, Polish, German, French, Portuguese, Ukrainian, Norwegian, Lithuanian, Greek, Slovak, Swedish, Russian
• Simple login — One shared password per instance
• Rate limiting — Brute-force protection on login attempts
• REST API — Access programmatically for integrations and migrations
• Import / Export — Move your data in and out via JSON or CSV

• Backend: Go 1.21 + Fiber
• Frontend: HTMX + Alpine.js + Tailwind CSS
• Database: SQLite

You can run Bentomo Shopping directly on your machine using Go. This works on macOS, Linux, and Windows.

macOS (Homebrew):

brew install go

Linux (Debian/Ubuntu):

sudo apt install golang-go

Windows: Download from go.dev/dl

git clone https://github.com/Bolex80/Shopping.git
cd Shopping
go run main.go

App available at http://localhost:3000

Default password: shopping123

To set a custom password:

APP_PASSWORD=yourpassword go run main.go

docker run -d -p 3000:80 -e APP_PASSWORD=yourpassword -v shopping-data:/data ghcr.io/bolex80/shopping:latest

App available at http://localhost:3000

git clone https://github.com/Bolex80/Shopping.git
cd Shopping
docker build -t bentomo-shopping .
docker run -d -p 80:80 -e APP_PASSWORD=your-password -v shopping-data:/data bentomo-shopping

Set WEBHOOK_URL to receive asynchronous HTTP POST notifications when items change. Accepted events are first stored in a SQLite outbox, then delivered in order. Failed deliveries use exponential backoff and survive application restarts. Delivery is at least once, so consumers should deduplicate using the stable event id.

WEBHOOK_URL=https://automation.example.com/webhook/koffan \
WEBHOOK_SECRET=replace-with-a-random-secret \
WEBHOOK_EVENTS=item.created,item.completed,item.deleted \
go run .

Each request includes Content-Type: application/json, an X-Koffan-Event header, and a JSON body:

{
  "id": "32f46c85bf51499cac2131cdbf18d78c",
  "event": "item.created",
  "timestamp": "2026-08-01T10:30:00Z",
  "data": {
    "item": {
      "id": 42,
      "section_id": 3,
      "name": "Milk",
      "description": "",
      "completed": false,
      "uncertain": false,
      "quantity": 1,
      "sort_order": 0,
      "created_at": "2026-08-01T10:30:00Z",
      "updated_at": 1785580200
    },
    "section": {"id": 3, "name": "Dairy"},
    "list": {"id": 1, "name": "Weekly groceries"}
  }
}

When WEBHOOK_SECRET is set, Koffan adds X-Koffan-Signature-256: sha256=<hex digest>. Verify it by computing HMAC-SHA256 over the raw request body with the same secret. If WEBHOOK_EVENTS is omitted, all four supported events are delivered.

git clone https://github.com/Bolex80/Shopping.git
cd Shopping
docker compose up -d

App available at http://localhost:80

1. Add new resource → Docker Compose → Select your Git repository or use https://github.com/Bolex80/Shopping
2. Set domain in Domains section
3. Enable Connect to Predefined Network in Advanced settings
4. Add environment variable APP_PASSWORD with your password
5. Deploy

Data is stored in /data/shopping.db. Mount a volume to that path to ensure your data persists across container restarts.

This is a personal fork maintained for family use. Feel free to:

• Fork and adapt for your own household
• Open issues for bugs or suggestions
• Submit pull requests for improvements

MIT License with Commons Clause.

You are free to use, modify, and share this software for any purpose, including commercial use within your organization. However, you may not sell the software or offer it as a paid service.

Built with care for families who shop together