currychern/bounti

Connecting neighbors to end food waste. A food recovery app.

Bounti

Bounti is an app that allows neighbors to share surplus food so it won't go to waste. We hope to foster community and help end food waste.

Contents

• Welcome!
• Project Description
• Recent News
• Roadmap
• Our Team
• Contributing
  • Design
  • Development

Welcome!

We're Bounti! Our team includes developers and designers. We are looking for more stakeholders in the community to be involved in the project. We are also looking for a project co-lead to help onboard new members, prioritize tasks, help with documentation, and conduct community outreach.

We are interested in bringing attention to the issue of wasted food and we are excited about the potential to get everyone in the community benefiting from less waste.

Thanks for coming here to learn more!

Project Description

We are a team of developers and designers working to build an app that allows neighbors to share surplus food to help alleviate hunger and end food waste.

Here in the United States, we waste about 40% of the food we produce. Meanwhile, 1 out of every 6 households in here in Texas suffers from food insecurity. Teenagers and college students avoid asking for food assistance due to the social stigma around hunger and poverty. We hope to engage this audience and the broader community by making a network where sharing food is not only acceptable, but encouraged. 😀👏

Our app complements the efforts of food recovery organizations by focusing on the food we as individuals waste everyday. We are creating a peer-to-peer network to make everyone an active stakeholder in helping solve the problem of wasted food! 😋🍴

Recent News

Bounti was started at ATX Hack for Change. We got a lot done during the hackathon and are trying to continue the momentum for a MVP rollout.

We're currently meeting in real life twice a month at Open Austin's Civic Hack Nights, check Meetup for upcoming hack nights.

Roadmap

At this stage, we have:

1. v2 designs of Bounti. See examples here and here and here.

2. A prototype that still needs a fair amount of work to get to version 1.0.

We are currently working on:

1. Implementing the v2 designs of Bounti.

2. Pulling data from Firebase.

3. Creating the form submission page.

We are looking for more developers with React Native and Firebase experience and a project co-lead to help us achieve our goal.

Our Team

• Project Lead:
  • Curry Chern
• Planning:
  • Jennifer Jiang
• Design:
  • John Dowd
• Development:
  • Kristin Faner
  • Jimmy Hsu
  • Aunteek Naser
  • Christina Nick
  • Bryan Chang
  • Shelby
  • William
  • John

Contributing

This project has received contributions from some wonderful volunteers. We would love to add your name to the list below. Over the course of this project, we have opportunities to help with design, development, QA & testing, writing, and more. To contribute, you can:

• Report a bug or request a feature by opening a new issue.
• Review open issues and leave a comment if you'd like to help or if you need more information.

For more information, check out CONTRIBUTING.md

Additional Contributors

• Bryan Chang - React Native

Design

Here is a link to our design assets and documentation. Here are open issues labeled "Design" where you can discuss, provide feedback or volunteer to help.

Development

The Bounti app is primarily written in javascript and uses the React Native library. We have future plans to implement Redux. Data submitted to the server lives in Firebase, a Google cloud service.

Getting started

This project has a dependency on Node and npm. Make sure they are install on your machine by running the following commands: node -v npm -v

This should return the version number of your install. If it doesn't Google how to install Node & npm for your operating system. Maybe these links could help you?

• Ubuntu
• Mac

We recommend using the yarn package manager to install the project. You can check if it is on your machine by running: yarn -v

You can run the following command to install yarn:

npm install -g yarn

Once you have cloned this repo to you local machine, open the bounti directory in your Terminal.

cd bounti

Installation

1. yarn install

Using Expo

The project uses Expo, which enables you to view the app directly on your phone instead of an emulator.

1. Download the Expo App on your phone.

2. Make sure your phone and your machine are connected to the same local network. (An easy way to do this is to open a mobile hotspot and connect your computer to your phone's network).

Starting the App

1. npm start

2. scan the QR code using the Expo app OR if you are using an emulator follow these directions

---

Tools

• Slack: Slack is messaging platform built for teams. Ask @currychern for access to the slack group. We hope to automate signup at some point in the future.
• Github: Github is a cloud-based Git repository hosting system. You're here! Hopefully not by mistake.
• Waffle: Waffle is a ticket system for Github issues. It helps teams visualize what's going on. Unfortunately, it doesn't come with a free waffle.

bounti's Issues

Implement v2 Design Item View

Update the ItemView to use the newest design. Look at the design folder for reference.

Ngrok bad hash

Running Linux Mint 18.1, 4.8.0-54-generic

Walked through setup, and at yarn install I get the following error:

$ yarn install
yarn install v0.24.5
[1/4] Resolving packages...
[2/4] Fetching packages...
error https://registry.yarnpkg.com/@exponent/ngrok/-/ngrok-2.2.7.tgz: Bad hash. Expected "37fe66f922b1003da2a78c66b7d4d3bc9313e423" but got "6c4a98fb138289a05788ac586676f7f153aecfcd" 
info Visit https://yarnpkg.com/en/docs/cli/install for documentation about this command.

Logo Design

We would like to design a logo for Bounti that is not directly tied to the name in the event we want to change it. Look at our design folder to look at the mockups and other design ideas we've come up with and make sure the logo ties in.

Implement Choice Splash Page

Implement the splash page that prompts users to choose whether they are donating food or searching for food.

Implement v2 Design - ListView

Update the ListView to use the newest design. Look at the design folder for reference.

Waffle Setup

Setup Waffle board for the Bounti Github repository.

Can't dynamically add references to images within List component

For the List component, the require statement in the image source has to be static. You can't pass the listing object as a prop and grab the image name:

// This will not work
<Image source={require('../../../img/' + this.props.food)} style={styles.listing}>
  ...
</Image>

// This will work
<Image source={require('../../../img/fresh-carrots.jpg')} style={styles.listing}>
  ...
</Image>

The docs explain that require statements in images must be static: http://facebook.github.io/react-native/releases/0.44/docs/images.html

This leaves the app with less flexibility, especially if integrating a search feature in the future.

Current discussion: facebook/react-native#2481

Populate React Components with Data from Firebase

Figure out how to populate React Native components with data from Firebase instead of hard coding everything. Then, remove the information that is hard-coded and replace it with the data coming from Firebase.

Add Search Bar Component

Add a search bar component to the React Native app. Make sure that the user can type into the bar and submit a search.

Implement Form View

Create a FormView that will allow users to take a photo of their donation, type in and select relevant information, and create a listing!