aaryansinha16/MohallaMart

MohallaMart is an e-Commerce multi-user website, where users can buy products, add reviews , become a seller etc. It has a admin dashboard where user can manage things accordingly.

Mohalla Mart

An awesome Ecommerce website with a number of features!


View Demo · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Roadmap
5. Contributing
6. License
7. Contact
8. Acknowledgments

About The Project

MohallaMart is an ecommerce website with role-based-access(Buyer/Seller/Admin). This is an individual project with took around 8 days to complete.

Features:

• Role-based-access(Buyer/Seller/Admin).
• Dynamic review/rating system (Product rating changes in real time after adding a review)
• Become a Merchant!! (there's an option for buyers to become a 'Seller' and sell their goods)
• Create a new product (This option is only available once you become a seller)
• Razorpay Payments! (Not sure if your payments are safe?? Not an issue razorpay is here to save your day!)
• Want to see your past records? There is a dashboard for all the roles where they can see ther purchases.
• Authentication
• WebSockets (used SocketIO for adding review part) //! In the deployed version I had to remove the SocketIO as free deploying services were not allowing it... Working fine in local version though
• Responsive and Modern Web Design!
• A complete ecommerce flow.

Currently Working on:-

• OAuth
• Adding Multer to make user profile
• Converting the localstoage model to session cookies

(back to top)

Built With

This section should list any major frameworks/libraries used to bootstrap your project. Leave any add-ons/plugins for the acknowledgements section. Here are a few examples.

• 
• 
• 
• 
• 
• 
• 
• 

(back to top)

Getting Started

The setup of the project is quite easy. Clone the repository, there are two main folders named "Frontend" & "Backend". You need to setup both server(Backend) & frontend(Frontend) seperately.

Prerequisites

Node version 14 OR 14+ is preferable, to check your current node version you can use the command below-

• npm

  node -v

Installation

Step by step setup of the project in local environment.

1. Clone the repo

   git clone https://github.com/aaryansinha16/MohallaMart.git

2. First let's start the backend server

   cd Backend

3. Install node modules

   npm i

4. Finally Start Command

   npm start

   With this your backend server is live now(locally), Now to start the frontend create a new instance of terminal in the same folder then:-

5. Go to the frontend folder

   cd Frontend

6. Install node modules

   npm i

7. Finally Start Command

   npm run dev

NOTE: I have used Vite + React in frontend, thus remember to use npm run dev for start command

(back to top)

Some Screenshots of the Project

Hero- Footer- Single Product- Responsiveness-

(back to top)

See the open issues for a full list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

Contact

Aaryan - @aaryansinha16 - aaryansinha16@gmail.com

Project Link: https://mohallamart.vercel.app

(back to top)