sanika391 / SpoonShare_

SpoonShare: An app connecting users to share free food, donate, and access local ngo, supporting the UN's Zero Hunger goal.
https://spoonshare-meal.web.app
MIT License
3 stars 0 forks source link

πŸ† Featured in:

Event Logo Event Name Event Description
GSSoC 24 GirlScript Summer of Code 2024 GirlScript Summer of Code is a three-month-long Open Source Program conducted every summer by GirlScript Foundation. It is an initiative to bring more beginners to Open-Source Software Development.

Table of Contents

πŸ’‘ Introduction 🌐 Live Preview πŸ“œ SpoonShare Project πŸ“½οΈ Intro To SpoonShare Video πŸš€ Getting Started 🀝 Contributing Guidelines βš™οΈ Installation Docker Docker Compose Without Docker πŸ“š Resources πŸ–ΌοΈ Screenshots πŸ“œ Code of Conduct ✨ Key Features πŸ” Additional Features πŸ› οΈ Tech Stack πŸ—οΈ SpoonShare Project Implementation Overview πŸ“ License πŸ‘₯ About Us

SpoonShare πŸ₯£

πŸ’‘ Introduction:

Problem Statement: Inadequate surplus food distribution generates hunger, necessitating a comprehensive solution. Our project addresses this challenge through an innovative platform, connecting donors with recipients to bridge the gap in food distribution.

Solution: SpoonShare is an innovative Android application designed to address the critical issue of food insecurity by seamlessly connecting those with surplus food to individuals and NGOs in need. Our platform is committed to reducing food waste, fostering sustainability, and actively supporting the UN’s Sustainable Development Goals (SDGs) of No Poverty and Zero Hunger by 2030.

Live Preview-

Download the APK:

Experience SpoonShare firsthand by visiting the deployed version:

Join us in the mission to minimize food waste, foster community engagement, and make a positive impact on the world!!!

Spoon Share is an Android app that fights food insecurity by connecting surplus food donors with those in need. Our goal is to reduce food waste, tackle child malnutrition, and promote sustainability. Join us in achieving UN Sustainable Development Goals 1 (No Poverty) and 2 (Zero Hunger) by 2030. Together, let's make a meaningful impact on food distribution and well-being.

SpoonShare Project:

Intro To SpoonShare Video

Intro To SpoonShare

Short but detailed introduction to SpoonShare. Click on the image above to watch the video.

Getting Started

Before running the project, make sure you have the necessary files downloaded:

  1. firebase_options.dart: Located in the lib folder.
  2. google-services.json: Located in the android/app/ directory.

You can download these files from the following links:

Contributing Guidelines

If you are willing to contribute to this project then you must go through Contributing Guidelines carefully.

Installation

To install and run the project, follow these steps:

  1. Clone this repository to your local machine.
  2. Place the downloaded firebase_options.dart file in the lib folder.
  3. Place the downloaded google-services.json file in the android/app/ directory.

Setup:

With Docker

  1. Clone the repository:
    git clone https://github.com/shuence/SpoonShare
  2. Navigate to the project directory:
    cd SpoonShare
  3. Build docker Image (only needed during first installation)
    docker build -t spoonshare:latest .     
  4. Run docker image
    docker run -d -p 80:80 spoonshare:latest

    The app should now be running at http://localhost:80.

With Docker Compose

  1. Clone the repository:
    git clone https://github.com/shuence/SpoonShare
  2. Navigate to the project directory:
    cd SpoonShare
  3. Build docker-compose (only needed during first installation)
    docker-compose up --build               
  4. Run docker-compose
    docker-compose up

    The app should now be running at http://localhost:80.

Without Docker

git clone https://github.com/shuence/SpoonShare
cd SpoonShare
flutter pub get
flutter run

Resources

Screenshots

    
     
     
     
  

Code of Conduct

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

Key Features:

  1. Surplus Food Map: -Easily locate surplus food donations on an interactive map that displays available resources within a 30km radius. This feature enhances accessibility and helps users navigate to nearby food donations efficiently.
  2. User-Friendly Interface:
    • Designed with an intuitive interface that ensures effortless navigation for all usersβ€”whether they are donors, recipients, volunteers, or NGOs. The user-centric design promotes accessibility and usability, making it simple for anyone to engage with the platform.
  3. Real-Time Updates:
    • Receive immediate alerts about new food donations and updates, allowing users to act quickly and reduce food waste. This feature ensures that surplus food is distributed in a timely manner, minimizing unnecessary waste.
  4. Volunteer Matching:
    • Connect volunteers with food distribution roles that match their preferences and availability. This feature enhances community involvement by aligning volunteer opportunities with individual interests and schedules, fostering greater participation and support.
  5. Quality and Safety Standards Verification:
    • Adhere to strict protocols to ensure the safety and quality of all donated food. Comprehensive verification processes guarantee that donations meet regulatory standards and are suitable for consumption, prioritizing the health and safety of recipients.
  6. Collaboration with Local Governments and NGOs:
    • Build effective collaborations with local authorities and non-governmental organizations (NGOs) to optimize food distribution operations. By leveraging these partnerships, SpoonShare enhances resource utilization, complies with regulatory requirements, and improves overall operational efficiency.

Additional Features:

Tech Stack

Archtectural-diagram.png

SpoonShare Project Implementation Overview

Technology Stack

User Interface (UI) Design

Educational Resources

Volunteer Matching

Quality and Safety Standards Verification

Feedback and Ratings System

Collaboration with Local Governments

Marketing and Awareness

Post-Launch Optimization

Community Building and Partnerships

LICENSE

This project is under this LICENSE

Hi, We are InnovisionSquad! πŸ‘‹

πŸš€ About me

I am from Deogiri Institute of Engineering And Management Studies Chh. Sambhajinagar and Core Team Members of GDSC DIEMS

Happy coding πŸ’―

Made with love from [InnovsionSquad]() ❀️