SwipeCart

SwipeCart is a full-stack E-commerce platform built using MERN stack with TailwindCSS and MUI as UI-toolkit.

Features

• Secure user authentication and session storage using jwt-tokens.

• Product catalogs with search, filter and pagination functionalities.

• Detailed product description with add to cart functionality.

• Secure product checkout and payment gateway with Stripejs.

Demo

Watch the video demonstration of the same:

https://youtu.be/icyQ7u3b87c?si=SHoRcXrXUfAIUSLG

Installation

Follow the steps below to install and run the project.

Prerequisites

Make sure you have the following installed on your machine:

• Node.js (which includes npm)

Clone the Repository

First, clone the repository to your local machine using git.

git clone https://github.com/Sumitkevlani/SwipeCart.git
cd SwipeCart

For frontend

  cd frontend
  npm install
  npm run dev

For backend

  cd backend
  npm install
  npm run dev

API Reference

Register user

  POST /api/user/register

Parameter	Type	Description
name	string	Required
email	string	Required
password	string	Required
avatar	file	Not Required

Login user

  POST /api/user/login

Parameter	Type	Description
email	string	Required
password	string	Required

Logout user

  GET /api/user/logout

Forgot password

  GET /api/user/forgot-password

Parameter	Type	Description
email	string	Required

Reset password

  PUT /api/user/password/reset/:token

Parameter	Type	Description
password	string	Required
confirmPassword	string	Required

Get all products

  GET /api/product/get-all-products

Create a new product(Admin only)

  POST /api/product/admin/create-product/new

Parameter	Type	Description
name	string	Required
description	string	Required
price	number	Required
ratings	number	Not Required
images	array	Not Required
category	string	Required
Stock	number	Required
numOfReviews	number	Required
reviews	array	Not Required

Update product details(Admin only)

  PUT /api/product/admin/update-product/:product-id

Parameter	Type	Description
name	string	Required
description	string	Required
price	number	Required
ratings	number	Not Required
images	array	Not Required
category	string	Required
Stock	number	Required
numOfReviews	number	Required
reviews	array	Not Required

Delete a product(Admin only)

  DELETE /api/product/admin/delete-product/:product-id

Get a specific product

  GET /api/product/get-product-details/:product-id

Search a product

  GET /api/product/get-product-details?keyword={keyword}

Filter a product

  GET /api/product/get-all-products?ratings[gte]={rating}

Pagination

  GET /api/product/get-all-products?page={page}

Get a user(Admin only)

  GET /api/user/admin/get-user/:user-id

Delete a user(Admin only)

  DELETE /api/user/admin/delete-user/:user-id

Update user role(Admin only)

  PUT /api/user/admin/update-role/user-id

Parameter	Type	Description
name	string	Required
email	string	Required
role	string	Required

Get all users(Admin only)

  GET /api/user/admin/get-all-users

Upate Profile

  PUT /api/user/update-profile

Parameter	Type	Description
name	string	Required
email	string	Required
avatar	file	Required

Upate password

  PUT /api/user/update-password

Parameter	Type	Description
oldPassword	string	Required
newPassword	string	Required
confirmPassword	string	Required

Get profile

  GET /api/user/profile

Create or update reviews

  PUT /api/product/reviews

Parameter	Type	Description
rating	number	Required
comment	string	Required
productId	objectId	Required
name	string	Required

Get all reviews

  GET /api/product/reviews?id={reviewId}

Delete a review

  DELETE /api/product/reviews?id={reviewId}&productId={productId}

Create a new order

  POST /api/product/admin/create-product/new

Parameter	Type	Description
shippingInfo	object	Required
orderItems	array	Required
paymentInfo	object	Required
itemsPrice	number	Required
taxPrice	number	Required
shippingPrice	number	Required
totalPrice	number	Required

Get single order(Admin only)

  GET /api/product/admin/get-single-order/:orderId

Get user specific order details

  GET /api/order/get-my-orders

Get all orders(Admin only)

  GET /api/order/admin/get-all-orders

Update order status(Admin only)

  PUT /api/order/admin/update-order/:orderId

Parameter	Type	Description
status	string	Required

Delete order(Admin only)

  DELETE /api/order/admin/delete-order/:orderId

Process a payment

  POST /api/payment/process-payment

Parameter	Type	Description
amount	number	Required

Get Stripe API Key

  GET /api/payment/stripeapikey

Environment Variables

To run this project, you will need to add the following environment variables to your .env file

PORT

MONGO_URI

SECRET_KEY

EXPIRE_TIME

COOKIE_EXPIRE

SMTP_HOST

SMTP_PORT

SMTP_USER

SMTP_PASSWORD

CLOUDINARY_NAME

CLOUDINARY_APIKEY

CLOUDINARY_APISECRET

STRIPE_PUBLISHABLE_KEY

STRIPE_SECRET_KEY

🔗 Links