Winner of the Inovation Prize from Société Générale during SmartHack 2021

Web application that helps large retail shops who are willing to donate food items approaching their expiration date, by putting them in contact with volunteers willing to transport them to homeless shelters.

📝 Table of Contents

• Getting Started
• Usage
• Built Using

🧐 About

The application features three types of accounts

• Homeless shelters, that can make item requests from the providers
• Providers, who can add the items they can donate to our system
• Volunteers, who can fulfill the requests by bridging the gap between shelters and providers

🏁 Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

Prerequisites

For the front-end side of the app, you require the following API keys:

• A Google API key inside the "ApiKey.json" file in the root directory, including the following APIs:
  • Maps JavaScript API
  • Places API
  • Geocoding API

For the back-end side of the app, you require the following API keys:

• A Firebase Admin Service Account key inside the root directory

🔧 Usage

To startup the front-end development server, run the following command:

npm start

To startup the back-end development server, run the following command:

DEBUG=smarthack:* npm start

⛏️ Built Using

• Front-end:
  • React
  • Bootstrap
• Back-end:
  • Express.js
  • MySQL