FreeToFosters

Free to Fosters is a way for foster families to find and recieve donated goods that they need. Users that are not foster families are able to upload items that they want to donate to the app and foster families can go onto the app and claim them. Foster families are also able to donate goods that they no longer use as well and create requests for items that they need.

Video

Screenshots

Technologies

• React Native
• Node.js
• Google Firebase

Installation to Get Set Up

1. Install Node.js v12 or Current version
2. Install React-Native npm install -g react-native-cli
3. Install dependencies
   1. Change directory to the project directory

       $ pwd
       your_path/FreeToFosters
      

   2. Run npm install and yarn install
4. Install CocoaPods (Mac OS platform)
   1. Run sudo gem install cocoapods if there is no result after runing which pod
   2. Change to the ios directory

       $ pwd
       your_path/FreeToFosters/ios
      

   3. Run pod install
5. Install Firebase
   1. Run yarn add firebase to add Firebase

Running

1. Android

   Run react-native run-android or yarn android in the project directory

2. IOS

   Run react-native run-ios or yarn ios in the project directory

Testing

Unit Testing

• We are using Jest to test our app.
• To download Jest Run ‘npm install’ or ‘yarn add –dev jest’ to add Jest. Run ‘npm run test’ or ‘yarn test’ to start the test.
• The directory where the tests are located is ‘tests’ and ‘e2e’.

Behavior Testing

• Set up: We are using Detox to use Behavior Testing and Detox runs only on the Mac OS/Linux system.

  // Mac OS only because XCode is only Mac OS.
  xcode-select install
  brew tap wix/brew
  brew install applesimutils
  // Mac and Linux platforms
  npm install -g detox-cli
  npm install detox --save-dev
  

• Andriod

  1. build app

     detox build --configuration=android.emu.debug

     or

     detox build --configuration=android.emu.release

     Configure testing device by changing avdName in package.json

        "device": {
          "avdName": "Pixel_2_API_27"
        }
     

  2. test

       npm start
       detox test -c android.emu.debug //or release
     

• iOS

  1. build app

     detox build --configuration=ios.sim.debug

     Configure testing device by changing type in package.json

      "device": {
         "type": "iPhone 11"
      }
     

  2. test

        npm start
        detox test -c ios.sim.debug
     

Meet the Team

Steven Childs

Junzhe Xue

Minqi Yu

Clayton Oney

Anna Bottu