🇲🇺 🇵🇰 🇳🇬 🇮🇳 🇻🇳 🇬🇭 🇬🇧

shopcube

shopcube is an e-commerce solution for shops. Complete with

• cart
• wishlist
• orders
• upload by csv
• charts
• theming

If you want to contribute, go ahead, we welcome it. We follow a 100% first-timers-friendly policy. Join #shopcube on Discord if you get stuck or would just like to chat and say hi.

Powered by Shopyo, a Python web framework built on top of Flask.

Quick Start

Installation

Clone the repository and set up a virtual environment:

git clone https://github.com/shopyo/shopcube.git
cd shopcube
python3 -m venv venv
source venv/bin/activate
pip install --upgrade pip setuptools
pip install -e .

Initialisation

To set up the database and default settings without clearing existing migrations:

cd src/shopcube
shopyo initialise --no-clear-migration

Running the Application

To run the development server:

flask run

Access the application at http://127.0.0.1:5000

Login as administrator:

• Email: [email protected]
• Password: pass

The dashboard is available at http://127.0.0.1:5000/dashboard/

Deployment

For production deployment, use a WSGI server like Gunicorn.

Example with Gunicorn

gunicorn --bind 0.0.0.0:8000 wsgi:application

Ensure you have a config.json in your execution directory. You can copy the demo config:

cp src/shopcube/config_demo.json config.json

Development

Running Tests

cd src/shopcube
python -m pytest

Useful Commands

flask flight-info