Open source shopping assistant
A fast and simple app for managing your shopping list together

Self-hosted app for your own server. Easiest way to deploy is with Coolify.

Koffan is a lightweight web application for managing shopping lists, designed for couples and families. It allows real-time synchronization between multiple devices, so everyone knows what to buy and what's already in the cart.

The app works in any browser on both mobile and desktop. Just one password to log in - no complicated registration required.

I needed an app that would let me and my wife create a shopping list together and do grocery shopping quickly and efficiently. I tested various solutions, but none of them were simple and fast enough.

I built the first version in Next.js, but it turned out to be very resource-heavy. I have a lot of other things running on my server, so I decided to optimize. I rewrote the app in Go and now it uses only ~2.5 MB RAM instead of hundreds of megabytes!

• Ultra-lightweight - ~16 MB on disk, ~2.5 MB RAM
• PWA - Install on your phone like a native app
• Offline mode - Add, edit, check/uncheck products without internet (auto-sync when back online)
• Organize products into sections (e.g., Dairy, Vegetables, Cleaning)
• Mark products as purchased
• Mark products as "uncertain" (can't find it in the store)
• Real-time synchronization (WebSocket)
• Responsive interface (mobile-first)
• Multi-language support (PL, EN, DE, ES, FR, PT)
• Simple login system
• Rate limiting protection against brute-force attacks

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

# Clone
git clone https://github.com/PanSalut/Koffan.git
cd Koffan

# Run
go run main.go

# App available at http://localhost:3000

Default password: shopping123

docker-compose up -d
# App available at http://localhost:80

git clone https://github.com/PanSalut/Koffan.git
cd Koffan
docker build -t koffan .
docker run -d -p 80:80 -e APP_PASSWORD=your-password -v koffan-data:/data koffan

1. Add new resource → Docker Compose → Select your Git repository
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. The volume ensures your data persists across deployments.

Have an idea? Check open feature requests and vote with 👍 on the ones you want most.

Want to suggest something new? Create an issue.

If you find this project useful, consider supporting its development:

MIT