MERN-Stack-Ecommerce-App

Fusion Electronics: A MERN-Stack E-commerce Application

Welcome to Fusion Electronics, a MERN-Stack E-commerce Application! This project is a working demo of a full-stack web application that was built using the MERN stack (MongoDB, Express.js, React.js, Node.js). Additionally, it also includes features such as user authentication, checkout process, product recommendations with vector search, and more!

It also aims to provide a comprehensive example of building a modern e-commerce platform, covering frontend user interface, backend server logic, database management, and integration with third-party libraries. Let’s dive in!

Fusion Electronics Logo

Table of Contents

  1. Introduction
  2. Live Deployment
  3. User Interface
  4. Features
  5. Technologies Used
  6. Getting Started
  7. Project Structure
  8. Running the Application
  9. Product Recommendations with Vector Database
  10. Testing the APIs
  11. Unit & Integration Testing
  12. Swagger API Documentation
  13. OpenAPI Specification
  14. Deployment
  15. Containerization
  16. GitHub Actions & CI/CD
  17. Contributing
  18. License
  19. Creator

Introduction

This project is a demonstration of building an e-commerce application using the MERN stack, which consists of MongoDB (database), Express.js (server), React.js (frontend), and Node.js (runtime environment). The application allows users to browse products, add them to a shopping cart, proceed to checkout, and simulate the order processing. It includes comprehensive validations for user inputs and simulates the checkout process on the backend.

The application is designed to be user-friendly and responsive, providing a seamless shopping experience. It also includes features such as product search, user authentication, and order confirmation. Additionally, it uses Pinecone (with optional Weaviate support) for product recommendations based on vector search, enhancing the user experience by suggesting relevant products.

React badge Node.js badge Express badge MongoDB badge Jest badge Material UI badge Weaviate badge Pinecone badge FAISS badge LangChain badge npm badge Vercel badge Render badge Swagger badge Docker badge Jest badge React Testing Library badge Git badge Postman badge Axios badge React Router badge Babel badge Webpack badge CRACO badge React Hook Form badge React Toastify badge React Credit Cards badge

Live Deployment

The application is deployed live on Vercel. You can access it at the following URL: Fusion Electronics App.

The primary backend server is deployed on Vercel and can be accessed at the following URL: Fusion Electronics API.

The backup backend server is deployed on Render and can be accessed at the following URL: Fusion Electronics API.

[!IMPORTANT] Note: The backend server may take a few seconds to wake up if it has been inactive for a while. For your information, it is hosted on the free tier of Render, with 0.1 CPU and 512 MB of memory only, so it may take a bit longer to respond to requests, especially after periods of inactivity.

[!CAUTION] Warning: The vector recommendation pipeline relies on Pinecone’s serverless index (free tier). Please make sure your Pinecone project has enough credits and remains active; otherwise, recommendation calls may fall back to heuristic suggestions. You can always run the application locally and provision your own Pinecone and/or Weaviate instances—see Product Recommendations with Vector Database for setup details.

User Interface

Home Page

Fusion Electronics Homepage

Fusion Electronics Recommended Products

Full Product List

Fusion Electronics Products List

Search Results

Fusion Electronics Search Results

Product Details Page

Fusion Electronics Product Details Page

Cart Page

Fusion Electronics Cart Page

Checkout Page

Fusion Electronics Checkout Page

Support Page

Fusion Electronics Support Page

About Page

Fusion Electronics About Page

Order Confirmation

Fusion Electronics Order Success Page

Order Tracking

Fusion Electronics Order Tracking Page

Shipping & Returns

Fusion Electronics Shipping & Returns Page

Terms of Service

Fusion Electronics Terms of Service Page

Privacy Policy

Fusion Electronics Privacy Policy Page

Login Page

Fusion Electronics Login Page

Register Page

Fusion Electronics Register Page

Forgot Password Page

Fusion Electronics Forgot Password Page

Reset Password Page

Fusion Electronics Reset Password Page

Fusion Electronics Footer

Features

[!TIP] When testing the checkout process, you can use the following test credit card number: 4242 4242 4242 4242 with any future expiry date and any CVC code. This is because we use Luhn algorithm validation for card number verification only, and no actual payment processing is done.

Technologies Used

Project Structure

The project is organized into two main “stacks”: The backend is in the backend directory that hosts all product & order data and the frontend is in the root directory. Here is an overview of the project structure:

fullstack-ecommerce/
├── backend/                       # Node.js server files
│   ├── config/                    # Configuration files
│   │   └── db.js                  # Database connection
│   ├── docs/
│   │   └── swagger.js             # Swagger API documentation setup
│   ├── models/                    # Mongoose models
│   │   ├── user.js                # User schema
│   │   └── product.js             # Product schema
│   ├── routes/                    # Route handlers
│   │   ├── products.js            # Product routes
│   │   ├── search.js              # Search routes
│   │   └── checkout.js            # Checkout routes
│   ├── middleware/                # Middleware functions
│   │   ├── auth.js                # Authentication middleware
│   ├── scripts/                   # Scripts for various tasks
│   │   ├── build-faiss-index.js   # Script to build FAISS index
│   │   ├── search-faiss-index.js  # Script to search FAISS index
│   │   ├── query-weaviate.js      # Script to query Weaviate
│   │   ├── weaviate-upsert.js     # Script to upsert products to Weaviate
│   │   ├── sync-weaviate.js       # Script to synchronize products with Weaviate
│   │   └── sync-pinecone.js       # Script to synchronize products with Pinecone
│   ├── seed/                      # Database seed data
│   │   └── productSeeds.js        # Product seed data
│   ├── services/                  # Shared services (e.g., Pinecone sync helpers)
│   ├── weaviateClient.js          # Weaviate client setup
│   ├── pineconeClient.js          # Pinecone client setup
│   ├── faiss.sh                   # FAISS index setup script
│   ├── .env                       # Environment variables
│   └── index.js                   # Server entry point
├── public/                        # Frontend public assets
│   ├── index.html                 # HTML template
│   ├── manifest.json              # Web app manifest
│   └── favicon.ico                # Favicon
├── src/                           # React.js frontend files
│   ├── components/                # Reusable components
│   │   ├── CheckoutForm.jsx       # Checkout form component
│   │   ├── ProductCard.jsx        # Product card component
│   │   ├── NavigationBar.jsx      # Navigation bar component
│   │   ├── OrderConfirmation.jsx  # Order confirmation component
│   │   ├── ProductListing.jsx     # Product listing component
│   │   ├── SearchResults.jsx      # Search results component
│   │   └── ShoppingCart.jsx       # Shopping cart component
│   ├── dev/                       # Development utilities
│   │   ├── index.js               # Development entry point
│   │   ├── palette.jsx            # Color palette
│   │   ├── preview.jsx            # Component preview
│   │   └── useInitials.js         # Initials hook
│   ├── pages/                     # Page components
│   │   ├── Cart.jsx               # Cart page component
│   │   ├── Checkout.jsx           # Checkout page component
│   │   ├── Home.jsx               # Home page component
│   │   ├── ProductDetails.jsx     # Product details page component
│   │   ├── OrderSuccess.jsx       # Order success page component
│   │   ├── ProductDetails.jsx     # Product details page component
│   │   └── Shop.jsx               # Shop page component
│   ├── App.jsx                    # Main application component
│   ├── App.css                    # Main application styles
│   └── index.js                   # React entry point
├── build/                         # Frontend production build files
├── tests/                         # Test files
├── .gitignore                     # Git ignore file
├── package.json                   # NPM package file
├── jsconfig.json                  # JS config file
└── setupProxy.js                  # Proxy configuration
(... and more files not listed here ...)

Getting Started

Prerequisites

Before running this project, ensure you have the following installed:

Installation

  1. Clone the repository: 
    git clone https://github.com/hoangsonww/MERN-Stack-Ecommerce-App.git
cd MERN-Stack-Ecommerce-App  # Fix the path if necessary
  2. Install project dependencies: 
    # Install server (backend) dependencies
cd backend
npm install
   
# Note: If you encounter any issues with the backend/package-lock.json not updating, run the following command from root directory:
npm install --no-workspaces --prefix backend

# Install client (frontend) dependencies
cd ..
npm install

  3. Set up the backend:

    • Create a .env file in the backend/ directory and add the following environment variable (replace the URI with your MongoDB connection string): 
      MONGO_URI=mongodb://localhost:27017/Ecommerce-Products
JWT_SECRET=your_secret_key

      For your information, I am using MongoDB Atlas for this project. You can create a free account and get your connection string from there if you want to deploy the application to the cloud.

    • Ensure that your MongoDB server is running. If you’re using Mac, you can start the MongoDB server with the following command: 
        brew services start mongodb-community
    • Seed the database with sample data: 
      cd backend/seed
node productSeeds.js dev
    • Run the backend server: (first cd into the backend directory) 
      cd ..
npm start
  4. Set up the frontend:
    • First, cd into the root directory if you are not already there: 
      cd ..

      Or

         cd fullstack-ecommerce
    • Start the frontend development server: 
      npm start

      [!TIP] The frontend server will run on http://localhost:3000 by default. If you encounter any errors when starting related to the react-credit-cards-2 package, it is OK to just ignore them as the application will still run correctly.

Running the Application

Product Recommendations with Vector Database

The application uses Pinecone as the primary vector database while still supporting Weaviate, FAISS, and LangChain for additional experimentation. Pinecone keeps MongoDB products and vector embeddings in sync automatically, ensuring recommendations remain fresh.

Configure Pinecone (required)

  1. Create a Pinecone project and serverless index (e.g., ecommerce-products) in the AWS us-east-1 region.
  2. Add the following variables to backend/.env: 
    PINECONE_API_KEY=your_pinecone_api_key
PINECONE_HOST=https://your-index.svc.YOUR-REGION.pinecone.io
PINECONE_INDEX=ecommerce-products
PINECONE_NAMESPACE=ecommerce-products # optional
GOOGLE_AI_API_KEY=your_google_ai_api_key
PINECONE_PURGE_ON_SYNC=true # set to false to skip clearing existing vectors during sync

    The Google AI key powers the embedding model (text-embedding-004).

  3. Sync MongoDB products into Pinecone: 
    cd backend
npm run sync-pinecone

    The backend also runs this sync during startup and re-syncs vectors automatically whenever products are created, updated (name/description/price/brand/image/category), or deleted. When PINECONE_PURGE_ON_SYNC is true (default), the sync clears the namespace first to prevent stale vectors building up.

Optional: Configure Weaviate & FAISS

  1. Provision a Weaviate instance at Weaviate Cloud and collect the host + API key.
  2. Add the variables to backend/.env: 
    WEAVIATE_HOST=https://your-weaviate-instance.weaviate.network
WEAVIATE_API_KEY=your_weaviate_api_key
  3. Index existing products in Weaviate: 
    cd backend
npm run weaviate-upsert
npm run sync-weaviate

    If you want the recommendation endpoints to prioritize Weaviate responses, set RECOMMENDATION_PREFER_WEAVIATE=true in backend/.env.

  4. (Optional) Build and query the FAISS index: 
    cd backend
node scripts/build-faiss-index.js
npm run faiss-search -- "your search text" 5

With Pinecone configured, product pages and bundles leverage vector similarity for recommendations. When Pinecone or Weaviate lookups have no matches, the API falls back to metadata-based heuristics to ensure users always see relevant suggestions.

[!TIP] Pinecone, Weaviate, and FAISS can comfortably coexist—keep your Pinecone index active for production traffic, and spin up Weaviate/FAISS locally when you want to compare engines or run experiments.

Testing the APIs

Unit & Integration Testing

We have implemented unit and integration tests for the application using Jest and React Testing Library. To run the tests, follow these steps:

Backend Tests

cd backend

# Run backend tests (default mode)
npm run test

# Run frontend tests (watch mode - this will automatically re-run tests on file changes)
npm run test:watch

# Run frontend tests (coverage mode - this will generate a coverage report)
npm run test:coverage

Frontend Tests

cd .. # if you are still in the backend directory

# Run frontend tests (default mode)
npm run test

# Run frontend tests (watch mode - this will automatically re-run tests on file changes)
npm run test:watch

# Run frontend tests (coverage mode - this will generate a coverage report)
npm run test:coverage

[!NOTE] If you encounter any issues when running the tests, ensure that you have run npm install in both the backend and root (frontend) directories to install all necessary dependencies.

Also, if the issue persists, try removing the node_modules directory and the package-lock.json file in both directories, and then run npm install again to reinstall all dependencies.

Swagger API Documentation

The MovieVerse App Interface

OpenAPI Specification

Using the openapi.yaml File

  1. View the API Documentation
    • Open Swagger Editor.
    • Upload the openapi.yaml file or paste its content.
    • Visualize and interact with the API documentation.
  2. Test the API
    • Import openapi.yaml into Postman:
      • Open Postman → Import → Select openapi.yaml.
      • Test the API endpoints directly from Postman.
    • Or use Swagger UI:
      • Provide the file URL or upload it to view and test endpoints.
  3. Generate Client Libraries
    • Install OpenAPI Generator: 
      npm install @openapitools/openapi-generator-cli -g
    • Generate a client library: 
      openapi-generator-cli generate -i openapi.yaml -g <language> -o ./client
    • Replace <language> with the desired programming language.
  4. Generate Server Stubs
    • Generate a server stub: 
      openapi-generator-cli generate -i openapi.yaml -g <framework> -o ./server
    • Replace <framework> with the desired framework.
  5. Run a Mock Server
    • Install Prism: 
      npm install -g @stoplight/prism-cli
    • Start the mock server: 
      prism mock openapi.yaml
  6. Validate the OpenAPI File
    • Use Swagger Validator:
      • Upload openapi.yaml or paste its content to check for errors.

This guide enables you to view, test, and utilize the API. You can generate client libraries, server stubs, and run a mock server using the OpenAPI Specification.

Deployment

To deploy the application:

Containerization

This project can be containerized using Docker. First, ensure that Docker Desktop is running on your system. Then, to create a Docker image, run the following command:

docker compose up --build

This command will create a Docker image for the frontend and backend, and run the application in a containerized environment.

GitHub Actions & CI/CD

This project includes a GitHub Actions workflow for continuous integration and deployment. The workflow is defined in the .github/workflows/ci.yml file and will automatically run tests and build the application on every push or pull request.

GitHub Actions Workflow

Contributing

Contributions to this project are welcome! Here are some ways you can contribute:

License

This project is licensed under the MIT License - see the LICENSE file for details.

Creator

Fusion Electronics was created with ❤️ by:

Thank you for exploring Fusion Electronics - a MERN Stack E-commerce Application! If you have any questions or feedback, feel free to reach out or open an issue.

Happy coding! 🚀

This site is open source. Improve this page.