Skip to content

Latest commit

 

History

History
171 lines (124 loc) · 3.55 KB

README.md

File metadata and controls

171 lines (124 loc) · 3.55 KB
Raw

logo-light logo-dark

New Store
A personal project that simulates an appliance e-commerce platform. Developed using Django, PostgreSQL, and styled with Tailwind CSS for a modern and responsive user experience.

Website (Render)

python-version django-version tailwind-version tailwind-version

Features

Key features of New Store include:

  • Smart Search.
  • User Registration.
  • Shopping Cart.
  • PayPal Payment Gateway.
  • Inventory Management.
  • Offers and Promotions.
  • Responsive Design.

Screenshots

Main_Light Main_Dark

See more screenshots....

Installation

Project

1. Clone the repository:

git clone [email protected]:tyronejosee/project_new_store.git

2. Navigate to the project directory:

cd project_new_store

3. Create a virtual environment:

python -m venv env

4. Activate the virtual environment:

# Windows
env\Scripts\activate

# Unix/Linux
source env/bin/activate

5. Install dependencies:

pip install -r requirements.txt

6. Perform database migrations:

Create the environment variables first, then run

python manage.py migrate

7. Start the development server:

python manage.py runserver

Tailwind CSS

1. Install Tailwind using npm (Node.js Required):

npm install -D tailwindcss

2. Compile Tailwind CSS styles:

npx tailwindcss -i ./static/css/input.css -o ./static/css/output.css --watch

Remember not to run npx tailwindcss init because there are already predefined styles for this project, and this command will overwrite the tailwind.config.js file.

Use two terminals for a better workflow, one for compiling Tailwind and another for running the Django development server.

Configuration

Create the environment variables.

# .env
SECRET_KEY=''
PYTHON_VERSION='3.11.7'
DB_NAME=''
DB_USER=''
DB_PASSWORD=''
DB_HOST=''
DB_PORT=''
CLOUDINARY_CLOUD_NAME=''
CLOUDINARY_API_KEY=''
CLOUDINARY_API_SECRET=''

Usage

Create a superuser to access the entire site without restrictions.

python manage.py createsuperuser

Start the development server and log in to admin.

python manage.py runserver
http://localhost:8000/admin/

Tests

Run tests globally.

python manage.py test

Or run individual tests per app.

python manage.py test users

License

This project is under the Apache-2.0 license.