JABS - A MERN stack e-commerce app

Table of Contents

• Features
• Demo
• Getting Started
• License
• Disclaimer
• Useful Links

Features

• JWT based Authentication
• Dedicated Admin Panel for Order processing
• Shopping Cart local state synchronized with server
• Payment Gateway integrated
• Cash on Delivery option available
• Email notification to the customer
• Order status tracking

Demo

You can create an account at JABS to explore the checkout flow, or use the below credentials to Sign-in.

Demo Credentials

• Email: customer@jabs.mern
• Password: superSecret545

Click here for the Live Demo

Getting Started

Get the repo

Download the .zip file from Github or run the below command to clone the repo locally.

git clone https://github.com/soumitdas/jabs.git

Install dependencies

After cloning the repo, run the following commands to install the project dependencies:

# for frontend
cd frontend && npm install

# back to the root directory
cd ..

## for backend
cd backend && npm install

Set environment

Frontend

Set the environment variable in .env file at frontend directory.

REACT_APP_API_BASE_URL=http://localhost:4000
REACT_APP_RAZORPAY_KEY=razorpay_public_key
REACT_APP_GOOGLE_CLIENT_ID=google_oauth_client_id_here

Backend

Rename .env.sample file in backend directory to .env and set the environment variables

FRONTEND_BASE_URL=http://localhost:3000
MONGODB_URI=
JWT_SECRET=super_secret
SMTP_USERNAME=
SMTP_PASSWORD=
AZURE_STORAGE_CONNECTION_STRING=
RAZORPAY_API_KEY=
RAZORPAY_API_SECRET=
GOOGLE_CLIENT_ID=

Run

Open two terminal window to run both the frontend & backend and run the following commands:

Frontend

cd frontend && npm start
# React App will start at PORT 3000

Backend

cd backend && npm run dev
# Node API server will start at PORT 4000

Now open http://localhost:3000/ to see the app running.

License

JABS is MIT licensed.

Disclaimer

This project is in a very basic stage and might have severe bugs and vulnerabilities, so please keep that in mind when deploying it to production.

Useful Links

• React
• Node JS
• Express
• Bulma