Freedom251 › Shopping List Apps
Koffan
What Koffan is
Koffan is a free, self-hosted shopping-list web app for couples and families managing lists together. Users can make separate lists for different stores or purposes, organize products into sections, and mark items as purchased or uncertain. After opening the app and signing in online, they can continue managing lists and products offline; pending changes sync when the connection returns. Offline page loads and an installed progressive web app require HTTPS, except on localhost for development. Optional accounts and workspaces support separate lists for multiple households on one server. The app works in desktop and mobile browsers and can be installed on a phone. Koffan also provides a REST API and signed outbound item-event webhooks, with examples including n8n, Node-RED, and Zapier. Webhooks can be filtered by event type and retried using SQLite-backed storage, but they are not scoped to a workspace and may receive item events from every workspace on the instance, including list and section names. Koffan includes login rate limiting. Its MIT License with Commons Clause permits use, modification, and sharing, but prohibits selling it or offering it as a paid service.
Who it suits
Koffan suits couples and families who want shared shopping lists and are comfortable self-hosting the app. It may also suit users who want a REST API, webhooks, or separate household workspaces.
What it does well
- Create multiple lists and organize items into sections.
- Lists can be managed offline after online sign-in.
- Optional workspaces separate household lists.
- REST API and signed item-event webhooks are included.
- Works in desktop and mobile browsers.
What to know first
- Offline page loads and installed PWA require HTTPS.
- Webhooks can receive events from every workspace.
- The license prohibits selling it as a paid service.
- Self-hosted deployment is required.
Plans
| Plan | Billed and limits | Price |
|---|---|---|
| Free self-hosted | Free software; may not be sold or offered as a paid service | Free |
As github.com lists them, read 11 Oct 2026. The maker's own page has the final word.
Verdict
Koffan provides shared lists, offline editing, and integration options in a self-hosted web app. Consider the HTTPS requirement and the broad scope of its webhooks before enabling them across multiple workspaces.
Facts from Koffan's own pages
- Accounts
- Optional accounts and workspaces let people use personal logins and keep separate lists for multiple households on one server. · github.com, 11 Oct 2026
- Browser support
- Koffan works in mobile and desktop browsers and can be installed on a phone as a progressive web app. · github.com, 11 Oct 2026
- Deployment
- The maker documents Docker deployment and running Koffan from source on macOS, Linux, or Windows. · github.com, 11 Oct 2026
- Integrations
- Koffan provides a REST API and signed outbound item-event webhooks, with examples including n8n, Node-RED, and Zapier. · github.com, 11 Oct 2026
- License
- Koffan uses the MIT License with Commons Clause, which permits use, modification, and sharing but prohibits selling it or offering it as a paid service. · github.com, 11 Oct 2026
- Login protection
- The app includes login rate limiting against brute-force attempts, configurable by failed-attempt count, time window, and lockout duration. · github.com, 11 Oct 2026
- Maker
- The GitHub organization profile identifies PanSalut as Artur Witoś. · github.com, 11 Oct 2026
- Offline requirement
- Offline page loads and the installed PWA require HTTPS, except that localhost works for development. · github.com, 11 Oct 2026
- Offline use
- After opening the app and signing in online, users can manage lists, sections, and products offline, with pending changes synchronized when the connection returns. · github.com, 11 Oct 2026
- Purpose
- Koffan is a lightweight shopping-list web app designed for couples and families to manage lists together. · github.com, 11 Oct 2026
- Shared lists
- Users can create multiple lists for different stores or purposes, organize products into sections, and mark items as purchased or uncertain. · github.com, 11 Oct 2026
- Webhook limitation
- Webhooks are not scoped to a workspace and can receive item events from every workspace on the instance, including list and section names. · github.com, 11 Oct 2026
- Webhook security
- Webhook payloads can be signed with HMAC-SHA256, filtered by event type, and retried using durable SQLite-backed storage. · github.com, 11 Oct 2026
- Workspace privacy
- The maker says workspace members can see that workspace’s lists, while people outside it cannot. · github.com, 11 Oct 2026
Where Koffan stands on Freedom251
- Shopping List Apps#12 of 31