The Problem

At the start of COVID-19, there was a shortage of essential supplies such as masks, hand sanitizers, and even toilet paper. Although many community leaders and nonprofits led the way through donations, the process of this distribution chain can be confusing, disorganized, and slow. Often, individuals in need may rely on donations from organizations, and then that organization relies on donations from another individual 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.


We want to fill this gap created by bureaucratic inefficiencies by enabling direct donations and requests between individuals. There are a lot of kindhearted people, especially during quarantine, contributing to others in need. We have each worked alongside such people who sew masks at home, donate gear to hospitals, and volunteer at homeless shelters (even before COVID-19). As a team of students who have had hands on experience helping our workers on the front-lines of the pandemic, we believe that essential goods are basic necessities, and that everyone is entitled to them regardless of their background, views, or socioeconomic status.

Our Vision

In order to reach more people in need, we decided to create a platform for donating essential goods that simplifies the process of giving. The goal of Supply is to be able to flawlessly connect voluntary donors to people (or organizations) that are in need of specific supplies. With this user-friendly app, we encourage users to give to others by showing them just how easy it is to donate, and to therefore increase the supply of essential products for those who need them.

How It Works

We wanted Supply to be clear and easy to navigate. So, it has four main screens (functions) accessible from the bottom navigation bar: Home, Create a Listing, Notifications & Messages, and Profile.

Home: On the home page, users can search for an essential product by using the search bar and/or choosing its respective category. To make it simple, we have five categories that an essential good can belong in: Medical, Hygiene, Water, Food, Clothing. Then, users can view posts of donors and requesters of that item. If they are interested in donating or requesting, they will be able to view more by just tapping on the post.

Create a Listing: Users can create a post as a donor or requester. Donors can post a picture, write a description, and set a time for when the item needs to be donated on the donor listing page. On the requester listing, requesters can post what item they need, the quantity of the item, and whether they can pick up the item.

Notifications/Messages: Users can accept or decline requests and donations in the notifications, as well as open or delete messages. The purpose of messages is to give an extra layer of clarification between donors and requesters.

Profile: On their profile page, users can view their current listings and their upcoming requests or donations that they have already agreed to.

Our Design

The logo of Supply was inspired by a price tag to signify the exchange of goods. However, instead of a cash symbol, we centered our design and logo around hearts to symbolize kindness, since donations stem from the heart. The string going through the tag also doubles as “S.”, which is short for Supply For our color scheme, we chose a color palette revolving around a pastel grey-purple (#DBCBD8) as it is a soft and warm color.

How we built it

We first used Figma to prototype the application and figure out what we wanted the application to look like to the end user. Based on these designs, we coded the application in Xcode using SwiftUI to power the backend logic and designs.

Challenges we ran into

Many of our challenges came from learning how to use SwiftUI and trying to untangle ourselves from merge conflicts.

(Just for context, UIKit is an older UI toolkit for iOS apps. At WWDC 2019, Apple introduced SwiftUI which is a newer UI toolkit based on declarative programming)

When we started the project, we decided to use UIKit to create our app since we were more familiar with the framework. However, due to UIKit’s API complexity, we ended up with several code conflict problems in git and created an even bigger problem for ourselves after a series of unsuccessful merges and checkouts.

We realized that we were heading into a dead end, and that SwiftUI’s simpler interface would help alleviate our problems. We took about 5 hours to speedrun through SwiftUI tutorials and get as familiar as we could with this new framework. We recreated the project in SwiftUI and even figured out how to recycle our UIKit code in combination with our new SwiftUI setup.

Accomplishments that we're proud of

Designing and prototyping our entire app interface on Figma to guide software development

Using Swift and Xcode to create an iOS application

Learning the SwiftUI framework

Solving the problems we faced regarding git and UI

Using React to build a landing page to promote our project

What we learned

We learned how to prototype our designs/ideas in Figma

We learned how to build iOS apps using the Swift UI framework

We learned how to create a landing page using React

What's next for Supply

Continue improving the UI and fleshing out more features in the backend

Built With

Share this project: