https://github.com/mousazourob/yum

(Cisco Webex Hackathon 3rd place winner) A responsive web application built with the MERN stack that facilitates the donation of excess food to help solve the food waste problem
https://github.com/mousazourob/yum

expressjs googlemaps-api jwt-authentication mapbox-api mongodb nodejs reactjs websockets

Last synced: 1 day ago
JSON representation

(Cisco Webex Hackathon 3rd place winner) A responsive web application built with the MERN stack that facilitates the donation of excess food to help solve the food waste problem

• Host: GitHub
• URL: https://github.com/mousazourob/yum
• Owner: MousaZourob
• Created: 2020-08-21T23:23:16.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2021-02-13T17:01:46.000Z (almost 4 years ago)
• Last Synced: 2024-11-05T11:16:43.423Z (about 2 months ago)
• Topics: expressjs, googlemaps-api, jwt-authentication, mapbox-api, mongodb, nodejs, reactjs, websockets
• Language: JavaScript
• Homepage:
• Size: 509 KB
• Stars: 0
• Watchers: 1
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Yum (Cisco Webex Hackathon 3rd place winner)

### Overview:

Did you know that **roughly one-third of the food produced in the world for human consumption every year (approximately 1.3 billion tonnes) gets wasted?** That is perfectly good food that is thrown away due to imperfections in shape and colour. Roughly 35% of wasted food is thrown out at supermarkets, shops, and households, much of which is perfectly suitable for eating! 





Introducing Yum! Built with the MERN stack, Yum is a responsive food sharing platform, meant to facilitate the donation and receival of food from donors to recipients. Donors and recipients can register using the register/login system, post listings, and chat with other users! By allowing both individuals and establishments to donate food, Yum aims to help solve the food waste problem and end hunger for the underprivileged.

### Features:

- Register an account and login, using a **JWT (JSON Web Token) based authentication** system. Passwords are securely salted and hashed using industry standard bcrypt before being stored in our database

- Using a back-end built with **Node.js and Express.js**, users can create, edit and delete new listings, as well as specify dietary restrictions and location, which are stored in a **MongoDB collection**

- Through a clean and visually apealing front-end built with **React and Boostrap**, users can view foods listed by other users as well as the location of each posting

- Built-in chat function built with **WebSocket** to facilitate meetings between donors and users and avoid phone call and email spam

- Interactive map built with the **Google Maps and Mapbox APIs**, to view the relative location of each listing, allowing users to better coordinate meeting up and dropping off

### Demo:

#### Register:

![Register](https://user-images.githubusercontent.com/66835262/104817903-584bd900-57f2-11eb-933f-78f3ce75402b.gif)

#### Sign-in/logout:

![Sign-in](https://user-images.githubusercontent.com/66835262/104818036-fe97de80-57f2-11eb-886e-249ff244aede.gif)

#### Create listing:

![Create](https://user-images.githubusercontent.com/66835262/104819010-dad79700-57f8-11eb-8cc3-6400c5fb2ce8.gif)

#### Edit and delete listing:

![Edit](https://user-images.githubusercontent.com/66835262/104818173-e3799e80-57f3-11eb-9cee-a0c06a4534ae.gif)

#### Chat:

![Chat](https://user-images.githubusercontent.com/66835262/104931574-94a74280-5974-11eb-892b-5b74154371dd.gif)

### Libraries and Frameworks Used:

* **React:** https://reactjs.org/

* **Express:** https://expressjs.com/

* **Node.js:** https://nodejs.org/en/

* **MongoDB:** https://www.mongodb.com/

* **Bootstrap:** https://getbootstrap.com/

* **Reactjs-popup:** https://react-popup.elazizi.com/

* **Axios:** https://github.com/axios/axios