Skip to content

ios app that allows donors and requestors to connect and get their essential supplies during times of need like covid or protests

License

Notifications You must be signed in to change notification settings

jojo39381/supply

Repository files navigation

about

Supply is an iOS application that enables users to donate and request essential items from their local community. Explore our landing page at https://supply-website.vercel.app/

why

COVID19 has created a shortage of essential supplies such as masks, hand sanitizer, and even toilet paper. The current system of distributing these items to those is need is extremely inefficient. Often, individuals in need may rely on donations from an organization, and then that organization relies on donations from other individuals and so on.

The inefficiencies of this distribution chain leaves holes where some people lack supplies they desperately need while others have too much of that same item. Our application fills the gaps created by bureaucracy by enabling individuals to directly donate to other individuals

how it works

2.5min video walkthrough with voiceover: https://youtu.be/WqlYebiv6cA

A user can sign up or log in with an existing account on our iOS application.

Note: During login, the keyboard may not dismiss unless you click the "return" button. Also, Camera functionalities does not work. Choose image from album instead.

open with xcode image open with xcode image

The home page shows a feed of donations and requests.

open with xcode image open with xcode image

When clicked, the listing will display specific information about the item, quantity, and pickup location.

open with xcode image open with xcode image

The user can make a new listing and choose between a request and donation

open with xcode image open with xcode image open with xcode image

The new listing will be reflected on the home page and on the users profile

open with xcode image open with xcode image

Note: the current version of the app doesn't support the camera

Hardware: works best on iPhone 7 and above

tech stack

We built the iOS application using Swift and Xcode.

For the UI design, we implemented a combination of UIKit and SwithUI views.

The login authentication is powered by Firebase.

The database is implemented in Firestore (currently in progress).

The landing page was made using React and is hosted on Vercel

Our wireframes and color palette are documented in Figma

download and clone this project locally

method 1

Click to the green code button on the top right of the repository and then click Open with Xcode open with xcode image

If this method does not work, then try the second installation method below

method 2

Make sure you have cocoapods installed. If not you can install cocoapods with the following command

sudo gem install cocoapods

Clone the repository using the command

git clone https://github.com/jojo39381/supply.git

After cloning the repository run the following command to install the required dependencies

pod install
  1. Direct Messaging: Allow direct messaging between donors and requesters within the app rather than just sharing contact info

  2. International shipping: Implement shipping and tracking so that users can donate anywhere in the world, not just their local community

  3. Support organizations: Develop inventory and logistics management for large donors or organizations

  4. Social awards: Implement donation stats and achievements to promote social engagement

  5. Crowdfunding: Allow for group donations and requests to enable crowdfunding-like activity

  6. Emergency support: Enable fulfillment of time-sensitive requests

Made with ❤️ and ☕️ from California

About

ios app that allows donors and requestors to connect and get their essential supplies during times of need like covid or protests

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published