Skip to content

Covid-19 Inspired Android App to help folks who can't leave their homes get groceries from family, friends, and neighbors who would like to shop for them.

Notifications You must be signed in to change notification settings

masher1/GroceryShare

Repository files navigation

GroceryShare

Covid-19 Inspired Android App to help folks who can't leave their homes get groceries from family, friends, and neighbors who would like to shop for them.

Table of Contents

Demo

GroceryShare Demo

Setup

  • Install Android Studio
  • Clone this repo to your local machine using: https://github.com/masher1/GroceryShare.git
  • Import the root folder of the project into Android Studio and wait for all the processes to finish in the bottom right corner.
  • Build project Gradle Setup Image1
  • In the Project window, right-click a testable item and select either Run filename or Debug filename. Android Studio creates a temporary run/debug configuration and launches your app.
  • Select Save from the Select Run/Debug Configuration drop-down list in the toolbar. If you do not see the toolbar, select View > Toolbar. Save the configuration
  • Open AVD manager and press "Create Virtual Device..." Setup Image2 Setup Image3
  • Choose a phone device of your choice (most of the testing was done on a Pixel 2) Setup Image4
  • Follow the AVD wizard, ensuring that System Image has an API of 29 or higher. Press finish once the wizard is complete. Setup Image5
  • Once the new emulator has been installed, run the project with the emulator. Setup Image6
  • Once the project has been built and installed onto the phone, the app will be fully functional for use. Setup Image7

Note:

  • We used Firebase's Realtime Database, Authentication, and Storage tools to build our application. Find out more about the tools we used here
  • We also utilized OneSignal to roll out notifications to users when certain trigers occured. Find out more about OneSignal here

Features

A new way for people in high-risk groups (immunocompromised, elderly, etc.) to receive their groceries. Order yourself, or order on behalf of a family member. Alternately, help a neighbor, or member of your community out by being a volunteer shopper.

For People Ordering Groceries:

  • Create your shopping list, customize the quantity, preferred brand, and store name
  • A volunteer shopper in your area will pick your order, upload a receipt with an order total, and drop off your groceries
  • You can pay for just the cost of the groceries, or you can tip your shopper. Your shopper will see your preferred payment method (Venmo, Paypal, etc.) before they accept your order.
  • Use your shopper’s phone number to communicate any clarifications or issues.
  • Once the shopper receives your payment, they will drop off your groceries, and you will receive a notification that your order is complete.
  • Communicate with your shopper via text to ensure a contactless delivery
  • View your order requests and past orders at any time
  • Fill out a complaint form in the app for any issues with the app or shopper
  • Update your personal information as necessary in settings or when you create an order

For People Buying And Delivering Groceries:

  • Pick an order after viewing the shopping list, rating of the requester, distance from your address, preferred store, and preferred payment method
  • Use the shopper’s phone number for any clarifications or issues
  • Upload the receipt and order total, and get paid for the cost of groceries by the requester
  • While buying and delivering is a volunteer service, a requester may tip you should they want to
  • Communicate with the requester via text to arrange the contactless delivery
  • View your past orders at any time
  • Fill out a complaint form in the app for any issues with the app or shopper
  • Update your personal information in settings as necessary

Team

Malkiel Asher Celeste Lemus Fiona Powers Beggs John Sobieski
Malkiel Asher Celeste Lemus Fiona Powers Beggs John Sobieski
https://github.com/masher1 https://github.com/clemus55 https://github.com/fcpowe https://github.com/jfsobieski

License

License

About

Covid-19 Inspired Android App to help folks who can't leave their homes get groceries from family, friends, and neighbors who would like to shop for them.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  

Languages