Food Shared is a web application that helps users easily find free food and other resources. It addresses the concern that although food banks and state-affiliated food assistance programs are crucial resources for millions experiencing food insecurity, these institutions present significant barriers for some individuals and families. The Food Shared directory highlights community-centered and mutual aid-driven resources with low barriers to access, including public pantries, community fridges, hot meals, and other accessible food assistance. Resources are accessible in ways that government and state-affiliated resources often are not or cannot be.
The directory is local to Portland, Oregon, but it will be expanded to include more locations in the future and will be updated regularly.
This project uses the MERN stack with RESTful API routes, React for the frontend and Express.js for backend.
Frontend dependencies:
- axios
- jest testing library
- babel
- dovenv
- mapbox
- mapbox-gl
- react
- react-bootstrap
- react-dom
- react-map-gl
- react-map-gl-geocoder
- react-mapbox-geocoder
- react-router
- react-router-dom
- yarn
- Git clone the repository:
git clone https://github.com/erinaperez/front-end-FS.git
- Install the dependencies by running
yarn add - Create a .env file on the root directory and add the variable:
REACT_APP_MAPBOX_ACCESS_TOKEN=YOURMAPBOXACCESSTOKEN
- Replace YOURMAPBOXACCESSTOKEN with your own Mapbox access token.
- Run the server with:
yarn start
You will need to install the backend repository to fully test development - https://github.com/erinaperez/backend-food-shared/
- Expand beyond Portland
- Complete the admin panel to moderate user submissions
- Deploy frontend and backend
- Add testing to ensure comprehensive code coverage
- Implement filters for the directory/map
- Improve zip code search and radius options
- Registration for users who run or organize resources
- Add a voluntary user survey to collect useful data
- Use data to show most frequently searched zip codes and most sought types of foods/resources
- Incorporate information on donating items or volunteering time
Input and feedback is welcome!