Fridge Finder

A community fridge is a decentralized resource where businesses and individuals can donate perishable food. There are dozens of fridges hosted by volunteers across the country. The Fridge Finder website is available at fridgefinder.app

Fridge Finder is based out of Brooklyn, New York. Our goal is to make it easy for people to find fridge locations and get involved with food donation programs in their community. We are building a responsive, mobile first, web application with administrative tools for fridge maintainers. To join the project read our contributing guidelines and code of conduct. The software architecture is documented in the programmer reference document.

Made possible by contributions from these lovely people …

❤ Thank you for all your hard work

System Requirements

1. Node

System Setup

1. Verify your system meets the requirements

   node --version  # must be >= 22.20.0

2. Install global dependencies

   npm install --global yarn svgo lint-staged concurrently
   corepack enable # for yarn

3. Setup the frontend environment

   git clone https://github.com/FridgeFinder/CFM_Frontend frontend
   cd frontend
   git checkout dev
   yarn install

4. Run the unit tests

   yarn test

5. Run the application locally

   # to run both development database and the web server
   yarn dev
   
   # to run only the web server on port 3000
   yarn web
   
   # to run only the database server on port 3050
   yarn data

   in a different terminal window

   start   "Google Chrome" http://localhost:3000/ # Windows
   open -a "Google Chrome" http://localhost:3000/ # MacOS