Skip to content

A fullstack project that aims to serve those facing food poverty by providing a one-stop-shop for both corporate and public volunteers to organise food donations and outreach, as well as for those in need to find local food banks.

Notifications You must be signed in to change notification settings

trinayau/FullFill

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 

Repository files navigation

Netlify Status Heroku License: MIT

Gebru Team 2 - Lap 4 Futureproof Final Project

Project FullFill

Description

FullFill is a fullstack project that aims to serve those facing food poverty by providing a one-stop-shop for both corporate and public volunteers to organise food donations and outreach.

Links

Client deployed via Netlify
Server deployed via Heroku
Final presentation available on Canva
Initial pitch and MVP available on Gist
Wireframes and planning available on Figma

Team Organisation

Team Member Role
Alfie Kelly Back End Development and Testing
Amarachi Umeloh Front End Development and Wireframing
Doreen Kamushinda Front End Development and Design
Thayaan Srisathialingam Front End Development and Testing
Trina Yau Front/Back End Development and Project Manager

Installation and Usage

To run locally:
Clone or fork this repo
Client:

  1. Run cd client/blogapi in terminal to enter React client directory
  2. Run npm install to install all dependencies
  3. Run npm start to start the server

Server:

  1. Run cd server in terminal to enter Django server directory
  2. Run pipenv shell to enter virtual enviroment
  3. Run pipenv install to install all dependencies
  4. Run `python manage.py makemigrations to start db
  5. Run python manage.py migrate to migrate changes!
  6. Run python manage.py runserver to start the server

A .env file is required for the client to run perfectly:

  • Make a .env file in client/blogapi
  • Inside the file: put REACT_APP_GOOGLE_KEY=YOUR_GOOGLE_MAPS_API_KEY please put your own Google Maps API key in here

Product (USP)

  • Not just providing a platform to find food banks, but also to allow people to organise themselves into grassroots volunteering groups to serve their local community.
  • In times of community distress and emergencies, the local community can organise around a website that directly serves this purpose rather than on social media which is less focused on the immediate need

MVP

Must-haves:

  • Food bank locator
  • User authentication
  • Ability to create and join community groups
  • Food donation page where charities post what food they need
  • Deployment

Should-haves:

  • Events/blog post section -> Admin get to post
  • Individual user profiles -> what community you are part of
  • Mailers -> sign up for newsletter for this week's volunteering opportunities

Could-haves/Stretch Goals:

  • User can add own profile photo

Technologies

Purpose Technology
Front End React using MaterialUI library
Back End Django using Django Rest Framework
APIs Give Food API, React Google Maps API, The Meal DB API
Database Development: Django default SQLite3, Deployed: Heroku PostgreSQL DB

Final Look

screencapture-fullfill-netlify-app-2022-10-20-09_55_35 screencapture-fullfill-netlify-app-locator-2022-10-20-10_04_39 screencapture-fullfill-netlify-app-donation-2022-10-20-10_05_11 screencapture-fullfill-netlify-app-communities-2022-10-20-10_06_58 screencapture-fullfill-netlify-app-communities-21-2022-10-20-10_07_33 screencapture-fullfill-netlify-app-profile-2022-10-20-11_23_26 screencapture-fullfill-netlify-app-profile-2022-10-20-11_23_26

About

A fullstack project that aims to serve those facing food poverty by providing a one-stop-shop for both corporate and public volunteers to organise food donations and outreach, as well as for those in need to find local food banks.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published