Skip to content

README.md

Latest commit

 

History

History
137 lines (99 loc) · 5.4 KB

README.md

File metadata and controls

137 lines (99 loc) · 5.4 KB

LinkedIn


Logo

PUNYA - Give today, so they can thrive tomorrow!

A platform developed for the Google Solution Challenge 🌍 to combat hunger by connecting donors, NGOs, and delivery agents 🚚. Featuring 'Hungry Spots 🍽️', PUNYA aims to reduce food wastage and ensure seamless food distribution to those in need.


Product Screenshot

About The Project

PUNYA is a project developed for the 2024 Google Solution Challenge 🌍, aimed at reducing food wastage and addressing hunger. By connecting food donors, NGOs, and delivery agents, the platform efficiently redistributes surplus food. With innovative features like 'Hungry Spots 🍽️,' users can donate surplus food to specific local areas in need. This project directly contributes to the United Nations' goal of achieving Zero Hunger by 2030.

Problem Statement

Over 1.2 billion people are suffering from hunger globally, while in India alone, massive quantities of food are wasted every day. The COVID-19 pandemic has exacerbated this issue, leading to food wastage in restaurants due to unpredictable business and lockdowns. On the other hand, many NGOs and communities face a severe shortage of food and resources.

Impact

PUNYA aims to efficiently connect donors, NGOs, and delivery agents to combat hunger. By utilizing innovative features like 'Hungry Spots,' the platform enables seamless surplus food distribution, fostering localized impact and contributing to the global goal of achieving "Zero Hunger."

Features

  • Donor, NGO, and Delivery Agent Registration: The platform optimizes registration for all user types, ensuring an efficient and transparent process.
  • Food Availability Posting: Donors can categorize and post surplus food details for NGOs to access.
  • Hunger Spots: Users can mark specific areas where there is a need for food, ensuring targeted and efficient distribution.
  • Real-Time Tracking: The platform provides real-time tracking for donations and deliveries.
  • Punya Coins: Delivery agents earn rewards in the form of Punya Coins, encouraging sustained engagement.

Built With

  • React
  • Redux
  • JavaScript
  • CSS3
  • TailwindCSS
  • Git

Getting Started

To get a local copy up and running, follow these steps.

Prerequisites

Ensure that you have Node.js and npm installed on your system.

  • npm 
    npm install npm@latest -g

Installation

  1. Clone the repo 
    git clone https://github.com/deepak-raaaz/solution-challenge-PUNYA.git
  2. Install NPM packages 
    npm install
  3. Create a .env file in the root directory and add the necessary API keys: 
    REACT_APP_API_KEY=your_api_key

Usage

  1. Start the development server: 
    npm start
  2. Visit http://localhost:3000 in your browser.
  3. Sign in or create an account.
  4. Begin contributing to reducing food wastage and hunger by donating food or managing hunger spots.

Contributing

Contributions are highly appreciated! Whether it’s reporting bugs, discussing new ideas, or adding new features, your input helps us improve.

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

License

Distributed under the MIT License. See LICENSE.txt for more information.

Contact

Deepak Kumar - deepakjamui26@gmail.com

Project Link: https://github.com/deepak-raaaz/solution-challenge-PUNYA

(back to top)