Souk is a web application for all your buying and selling needs.
Built using the MERN Stack(MongoDB, Express, React, NodeJS), Souk provides a user-friendly
platform for both vendors and customers to sell and purchase products respectively.
Some of the key highlights of Souk are:
- Vendor management- Vendors, after authentication, can list, dispatch and cancel products.
- Customer management- Customers, after authentication, can view the list of items available on the marketplace.
- Product comparison- Apart from being able to search for products by keyword, customers can also sort the products based on price and reviews from other customers.
- Cart- Customers can also see the products they have added to their cart, and edit/cancel their orders.
- Ratings and Feedback - Customers can leave ratings and reviews for the products they've purchased, which in turn would be visible to the vendors on their portals.
For Linux:
curl -sL https://deb.nodesource.com/setup_13.x | sudo -E bash -
sudo apt-get install -y nodejs
For Mac:
brew install node
Install the community edition here.
npm install -g create-react-app
To create a new React app:
create-react-app name_of_app
To run the app, cd into the directory and do:
npm start
Run Mongo daemon:
sudo mongod
Mongo will be running on port 27017.
Run Express:
cd backend/
npm start
Run React:
cd frontend
npm start
Navigate to localhost:3000/ in your browser.