No description
- HTML 58.6%
- Python 41.4%
| static | ||
| templates | ||
| app.py | ||
| logo.blend | ||
| models.py | ||
| README.md | ||
| requirements.txt | ||
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
- Log in with the admin credentials
- Create additional users via the Users page
- Create stores (any user can do this)
- Add items to stores
- Use the Overview page to mark items as bought
- View purchase history with filtering and pagination