HarvestHero

Overview

HarvestHero is a platform designed to facilitate the connection between individuals, restaurants, grocery stores, and other donors with NGOs and charities. The platform aims to efficiently distribute various resources such as food, clothes, monetary donations, books, toys, medical supplies, technology, and other essentials to those in need.

Purpose

The main purpose of HarvestHero is to streamline the donation process, making it easier for donors to contribute and for NGOs and charities to receive and distribute donations effectively. By providing a centralized platform, HarvestHero enables:

• Efficient Donation Matching: Donors can easily find NGOs and charities that are in need of specific types of donations, ensuring that resources are distributed where they are most needed.

• Enhanced Accessibility: Individuals, restaurants, grocery stores, and other potential donors can quickly connect with organizations dedicated to helping the community, fostering a sense of community engagement and support.

• Transparency and Accountability: The platform promotes transparency by providing clear visibility into how donations are used and distributed by NGOs and charities, building trust among donors and the community.

• Impact Tracking: HarvestHero allows users to track the impact of their donations, providing insights into the difference they are making in the lives of those who benefit from their contributions.

Key Features

• User Profiles: Donors and NGOs can create profiles detailing their donation preferences, needs, and impact stories.

• Donation Matching: Algorithms match donors with relevant NGOs based on donation types and geographical preferences.

• Real-time Updates: Notifications and updates on donation requests, distributions, and impact reports keep users informed.

• Secure Transactions: Built-in security measures ensure safe and reliable donation transactions.

How to Use

1. Sign Up: Create a donor or NGO profile to start donating or receiving donations.

2. Explore Donations: Browse through available donations or create a donation request specifying your organization's needs.

3. Connect and Donate: Connect with matching donors or NGOs and initiate donation transactions.

4. Track Impact: Monitor the impact of donations through real-time updates and reports.

Getting Started

Prerequisites

• Node.js (version 12 or above)
• npm (version 6 or above)
• Docker (for running PostgreSQL and Redis)

Installation

1. Clone the repository:

   git clone https://github.com/sajalbatra/HarvestHero
   cd HarvestHero

2. Install dependencies:

   npm install

3. Setup Docker containers: To run PostgreSQL and Redis using Docker, follow these steps:

   • Create a docker-compose.yml file:

     version: '3.8'
     
     services:
       postgres:
         image: postgres:13
         container_name: postgres
         environment:
           POSTGRES_USER: your_postgres_user
           POSTGRES_PASSWORD: your_postgres_password
           POSTGRES_DB: your_database
         ports:
           - "5432:5432"
         volumes:
           - postgres_data:/var/lib/postgresql/data
     
       redis:
         image: redis:latest
         container_name: redis
         ports:
           - "6379:6379"
     
     volumes:
       postgres_data:

   • Start the Docker containers:

     docker-compose up -d

   This will start PostgreSQL and Redis in the background, with PostgreSQL accessible on port 5432 and Redis on port 6379.

4. Start the development server:

   npm run dev

   The application will be available at http://localhost:3000.

Deployment

To deploy the application, you can use platforms like Heroku, Vercel, or any cloud provider of your choice.

Contributing

We welcome contributions from the community! If you'd like to contribute, please follow these steps:

1. Fork the repository: Click the "Fork" button at the top right of this page to create your own copy of the repository.

2. Create a branch:

   git checkout -b feature-branch

3. Make your changes: Implement your changes in the codebase.

4. Commit your changes:

   git commit -m "Description of the changes"

5. Push to the branch:

   git push origin feature-branch

6. Create a pull request: Go to the original repository and click the "New Pull Request" button to submit your changes for review.

Contributors

• Sajal Batra

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

We thank all our contributors and supporters who help make HarvestHero a success. Your efforts are greatly appreciated!