Skip to content

galassooo/FoodbanksApp

Repository files navigation

Dish Discovery

Table of contents

General info

The PSU-SUPSI Project6 is focused on developing an app or web application designed to support SDG #2 (Zero Hunger), which targets ending malnutrition, doubling agricultural productivity, and ensuring sustainable food production systems. The goal of the project is to facilitate easier access to food banks for users and provide a platform for businesses to donate surplus food to donation centers. The planned features of the app include a functional map for locating food banks, an informational "About" page, a settings menu for language customization, and secure login authentication. This project aims to use technology as a tool to promote food security and sustainable food distribution practices.

Desktop setup

Clone the repository

To get started, clone the repository using HTTPS by running the following command in your terminal:

git clone https://github.com/slashdotted/C4110Z.1-2024-Team-6.git

Install Flutter

Next, install the latest version of Flutter on your machine. Ensure that you install a version that is between 3.0 and 4.0. Follow the tutorial available at Flutter Installation Guide.

Verify Flutter Version

After installing Flutter, verify the version to make sure it falls within the required range by executing:

flutter --version

The version should be between 3.0 and 4.0. Update or downgrade if necessary to match the version requirement.

Install dependencies

Navigate to the directory where you cloned the project:

cd C4110Z.1-2024-Team-6

Then, download all the required project dependencies by running:

flutter pub get

Run the project

To run the project, use the following command:

flutter run web 

This command will start the Flutter project in a web environment.

Alternatively, you can open the project in your preferred IDE (we recommend Android Studio or Visual Studio Code) and run it from there. Make sure to configure the IDE to target the web platform.

Mobile setup

Clone the repository

To get started, clone the repository using HTTPS by running the following command in your terminal:

git clone https://github.com/slashdotted/C4110Z.1-2024-Team-6.git

Install Flutter

Next, install the latest version of Flutter on your machine. Ensure that you install a version that is between 3.0 and 4.0. Follow the tutorial available at Flutter Installation Guide.

Verify Flutter Version

After installing Flutter, verify the version to make sure it falls within the required range by executing:

flutter --version

The version should be between 3.0 and 4.0. Update or downgrade if necessary to match the version requirement.

Install dependencies

Navigate to the directory where you cloned the project:

cd C4110Z.1-2024-Team-6

Then, download all the required project dependencies by running:

flutter pub get

Obtain your IP address

Once done, you need to obtain the IP address of the machine where the repository was cloned using the command:

ifconfig

Or

ipconfig

Start a web server

Then, once you have the machine's IP address, you need to start the application on a web server using the command:

flutter run -d web-server --web-hostname <YOUR_IP_HERE>

Connect

Once launched, the command will return a URL from which you can connect via mobile to test the application.

Note: The mobile device on which you intend to run the application must be connected to the same network as the host machine.

Desktop visuals

Home screen

The main screen of the app, displaying our slogan and featuring a bar with options for navigating within the application.

Home image

Map screen

The screen displays an interactive map with the locations of food distribution points, such as food banks. Users can obtain directions to each distribution center and manage their favorite food banks.

Map image

Forum screen

Within the forum, users can exchange information and share recommendations about individuals/companies providing free food to those in need.

Forum image

About screen

The About screen provides general information about the project and statistics on the worldwide hunger situation.

About image

Settings screen

n the settings screen, users can set their preferred language from the six available options, select time and distance formatting preferences, and finally choose the application theme.

Menu image

Login screen

The login screen prompts users to log in or register to access the application's features.

Login image

Profile screen

The screen displays the user's profile, with personal information such as name, photo, and email address. In this section, users can edit their personal data, log out, and manage favorites.

Profile image

Mobile visuals

Immagine 1 Immagine 2 Immagine 2 Immagine 2 Immagine 2 Immagine 2 Immagine 2 Immagine 2 Immagine 2 Immagine 2 Immagine 2 Immagine 2

Authors

Martina Galasso

  • Role: Developer
  • Description: Martina was responsible for the development of the application, structuring the code entirely and implementing all the features. She managed the planning and execution of the project, coordinating the work of team members and ensuring adherence to timelines and objectives.

Francesco Fasola

  • Role: Developer
    • Description: Francesco contributed partially to the development of the layout of the first version of the application.

Status

Complete (Lastest version: 3.1.2)

Versions

v3.1.2

Added recovery password option

v3.1.1

Minor improvements

v3.1.0

Fixed rendering bug for mobile client

v3.0.2

Added rendering for using the application through a mobile browser, resolved web rendering issues. Improvements to the translation system.

v3.0.1

Various improvements made.

v3.0.0

Added preference saving, implemented login and signup, introduced new features to the forum and map, implemented profile image uploading, and user favorites management.

v2.2.0

A cookie policy has been added.

v2.1.1

Graphics enhancements to the application, addition of a home page

v2.1.0

The application's forum has been implemented, and an 'About Us' page has been added. New features have been added to the map.

v2.0.0

The graphical appearance of the application has been improved, and a login layout has been added.

v1.0.0

created the foundation of the application with a rudimentary design, this version includes a map and language settings.

About

Web application / mobile application coded in dart with login features, database access, geolocation services

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages