selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

our-shopping-list logo

Self-host our-shopping-list

4.2.0

Collaborative shopping list web app with real-time sync

Archived ReleaseOpen SourceAGPL-3.0
Updated8 months ago
LanguageJavaScript
Setup difficultyModerate
MobilePWA
ThemeDark mode
Stars
198
Port
8080 (HTTP/WebSocket server)
Requires
MongoDB
Docker
ourshoppinglist/our-shopping-list
Install with Docker
Mobile home screen showing boardsMobile menu navigationMobile search interfaceMobile list editingDesktop board viewDesktop swipe interactionDesktop item editingDesktop search interface

What is our-shopping-list?

A collaborative list web app built with Node.js and Vue.js that lets multiple people work on shopping or todo lists together in real time. It uses WebSockets for live updates and organizes items into boards, each containing multiple lists. Items have names, quantities, and details, and can be checked off. The interface works well on mobile with swipe gestures and offers basic PWA support. Several languages are available. The backend stores data in MongoDB (or FerretDB with PostgreSQL) and the server listens on port 8080. Deployment is via Docker or Docker Compose. The code is AGPL-3.0 licensed and hosted on Codeberg. Current gaps include no offline PWA mode, no MongoDB authentication, and no built-in user access control.

our-shopping-list alternatives

Should you self-host our-shopping-list?

our-shopping-list scores 47/100 on selfhost.directory (how scoring works) and ranks #19 of 34 in Task Management. It has 198 GitHub stars, +1 in the last 30 days.

The repository is archived, so don't expect new releases or security fixes.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is AGPL-3.0-licensed and written mostly in JavaScript.

Its closest alternative on selfhost.directory is Super Productivity (83/100, 23 913 stars). It scores higher overall, so compare the two before you pick. See our-shopping-list vs Super Productivity side by side.

Features

  • Checkable items
  • CSV Import
  • Display modes
  • Internationalization
  • Multiple boards
  • Real-Time Collaboration
  • Search
  • WebSocket API

our-shopping-list README

How to install our-shopping-list

Install our-shopping-list with Docker

Environment variables
LISTEN_PORT, MONGODB_HOST, MONGODB_PORT, MONGODB_DB, BASE_URL, VITE_APP_*

docker run --detach
--name our-shopping-list
--link mymongo:mongodb
--publish 80:8080
ourshoppinglist/our-shopping-list

Requires a running MongoDB container

How to configure our-shopping-list

  • LISTEN_PORT8080Port the server listens on
  • MONGODB_HOSTmongodbMongoDB host
  • MONGODB_PORT27017MongoDB port
  • MONGODB_DBoslMongoDB database name
  • BASE_URLBase path if web root is not /

our-shopping-list releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

More in Task Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…