No description
  • HTML 58.6%
  • Python 41.4%
Find a file
2026-11-21 21:03:48 +01:00
static Add icon to header bar, make it black and make add item the default and first tab 2026-11-21 21:03:48 +01:00
templates Add icon to header bar, make it black and make add item the default and first tab 2026-11-21 21:03:48 +01:00
app.py Add icon to header bar, make it black and make add item the default and first tab 2026-11-21 21:03:48 +01:00
logo.blend Add icon to header bar, make it black and make add item the default and first tab 2026-11-21 21:03:48 +01:00
models.py inital commit 2026-08-03 22:19:27 +02:00
README.md Add readme 2026-08-03 23:03:26 +02:00
requirements.txt use waitress, add requrmentents 2026-08-03 22:28:29 +02:00

Shopping List Application

A Flask-based shopping list manager with user management and store-based item organization.

Features

  • User authentication with admin account
  • User management (create, delete, set passwords) - admin only
  • Store creation - any registered user
  • Add items to stores
  • Overview page with items grouped by store
  • Mark items as bought with checkboxes
  • Purchased items history with pagination and store filtering
  • Configurable sub-path deployment

Installation

pip install -r requirements.txt

Configuration

Environment variables:

Variable Default Description
ADMIN_USER admin Admin username
ADMIN_PASSWORD admin123 Admin password
SECRET_KEY dev-secret-key-... Flask secret key
DATABASE_URL sqlite:///shopping.db Database connection
SUB_PATH (empty) Sub-path for deployment (e.g., /shopping)

Running

python app.py [--host HOST] [--port PORT] [--debug]

Arguments:

  • --host - Host address to bind to (default: 0.0.0.0)
  • --port - Port to bind to (default: 5000)
  • --debug - Enable debug mode

Examples:

python app.py --port 8080
python app.py --host 127.0.0.1 --port 3000 --debug

Sub-path Deployment

To deploy under a sub-path (e.g., www.example.com/shopping):

SUB_PATH=/shopping python app.py

Usage

  1. Log in with the admin credentials
  2. Create additional users via the Users page
  3. Create stores (any user can do this)
  4. Add items to stores
  5. Use the Overview page to mark items as bought
  6. View purchase history with filtering and pagination