Shared Shopping List Web App

About The Project

This project provides a central, self-hosted web application for a family or group to manage a shared shopping list. Any member can easily add items they need, creating a single, always-up-to-date list.

This web service is the final development step for the accompanying Android app. The goal is to allow the app to automatically sync with this web service.

Current Status & Workaround: While direct API integration in the app is still to be completed, the system is already fully functional using notifications. The text sent in the Gotify notification can be copied and pasted 1:1 into the Android app to instantly populate the shopping list.

How to Use

Here is an example docker-compose.yml file:

services:
  shopping-list:
    image: lxtools/noteshop-webapp:latest
    container_name: shopping-list
    restart: always
    ports:
      - "8080:8000" # Host-Port:Container-Port
    volumes:
      # For local development, use a relative path:
      - ./data:/app/data

      # For production, you might use an absolute path like this (choose one):
      # - /opt/containers/sharelist/data:/app/data

    environment:
      # Set the User and Group ID for file permissions.
      # Defaults to 1000 if not specified in your environment.
      - PUID=${PUID:-1000}
      - PGID=${PGID:-1000}
      # Your Gotify URL for notifications. Should be set in a .env file.
      - GOTIFY_URL=${GOTIFY_URL}

First Login

After starting the container for the first time, a default administrator account is created so you can log in.

• Username: admin
• Password: admin

Important: For security reasons, please log in and change the default password immediately using the admin panel.

Important Notes

• User/Group: Set PUID and PGID to your user's ID on the host system. You can find them by running the commands id -u and id -g.
• Data Directory: Before the first run, create a directory for the database: mkdir data.
• Running: Start the container with: PUID=$(id -u) PGID=$(id -g) docker compose up -d