README.md

ProShop eCommerce Platform (v2)

eCommerce platform built with the MERN stack & Redux.

This project is part of my MERN Stack From Scratch | eCommerce Platform course. It is a full-featured shopping cart with PayPal & credit/debit payments. See it in action at https://www.proshopdemo.dev

This is version 2.0 of the app, which uses Redux Toolkit.

• Features
• Usage
  • Env Variables
  • Install Dependencies (frontend & backend)
  • Run
• Build & Deploy
  • Seed Database

Features

• Full featured shopping cart
• Product reviews and ratings
• Top products carousel
• Product pagination
• Product search feature
• User profile with orders
• Admin product management
• Admin user management
• Admin Order details page
• Mark orders as delivered option
• Checkout process (shipping, payment method, etc)
• PayPal / credit card integration
• Database seeder (products & users)

Usage

• Create a MongoDB database and obtain your MongoDB URI - MongoDB Atlas
• Create a PayPal account and obtain your Client ID - PayPal Developer

Env Variables

Open cd backend Rename the .env-example file to .env and add the following

NODE_ENV = production
PORT = 5000
MONGO_URI = your mongodb uri
JWT_SECRET = 'abc123'
PAYPAL_CLIENT_ID = your paypal client id
PAGINATION_LIMIT = 8

Change the JWT_SECRET and PAGINATION_LIMIT to what you want

Install Dependencies (frontend & backend)

npm install
cd frontend
npm install

Run

# Run frontend (:3000) & backend (:5000)
npm run dev

# Run backend only
npm run server

Build & Deploy

# Create frontend prod build
cd frontend
npm run build

Seed Database

You can use the following commands to seed the database with some sample users and products as well as destroy all data

# Import data
npm run data:import

# Destroy data
npm run data:destroy

Sample User Logins

[email protected] (Admin)
123456

[email protected] (Customer)
123456

[email protected] (Customer)
123456

Docker Setup

Open backend folder and run this command:

docker image build .

Open frontend folder and run this command:

docker image build .

Open nginx folder and run this command:

docker image build .

Create volume for MongoDB Database

docker volume create proshop

After this run this command:

docker compose up

Seed database in docker container

docker container ls

Find proshop-api and run this command

docker container exec -it <proshop-api> sh

npm run data:import