Our Shopping List

Our Shopping List (OSL) is a lightweight web application for collaboratively managing shopping lists and small todo lists. It provides real-time synchronization between users, a mobile-first UI, and optional multi-board organization for grouping lists.

Key Features

• Real-time sync between clients using WebSocket for immediate updates
• Multiple boards and multiple lists per board (single-board mode available)
• Items with name, quantity, details and checkable state; checked-item history and display modes
• Mobile-first UI with swipeable list items and intuitive search
• Basic PWA support and internationalization (multiple locales available)
• Docker-ready deployment and a MongoDB backend; CLI tools to migrate lists/boards
• Configurable via environment variables for ports, DB host, UI behavior, and socket timeouts
• Notes and guidance for reverse-proxy setups to support WebSocket traffic

Use Cases

• Shared household shopping lists that sync in real time across family members
• Small collaborative todo lists for teams, events, or group tasks
• Mobile-first list management for users who want quick check/quantity workflows

Limitations and Considerations

• MongoDB authentication is not supported in current releases; plan deployments accordingly
• PWA support is basic and does not provide full offline deferred-sync capabilities
• Requires proper reverse-proxy configuration to forward WebSocket connections for SSL offloading

Our Shopping List is a simple, focused tool for collaborative list management with an emphasis on real-time updates and mobile usability. It is suitable for homes and small teams that need fast, shared list workflows.