COVID-19 Symptom Tracker

Table of Contents

• About The Project
  • Built With
• Getting Started
  • Prerequisites
  • Installation
• Roadmap
• Contributing
• Common Issues
• License
• Contact
• Acknowledgements

About The Project

COVID-19 Symptom Tracker is an open source Android and iOS app whose goal is to stop the spread of COVID-19 disease and help identify people who are at risk sooner.

The COVID-19 Symptom Tracker was designed by doctors and scientists at King's College London, Guys and St Thomas’ Hospitals working in partnership with ZOE Global Ltd – a health science company.

If you're doing research on COVID-19 and you want to contribute or believe this initiative can help your efforts, please let us know at research@joinzoe.com

Built With

• React Native
• Expo

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

Prerequisites

• npm
• expo-cli

npm install npm@latest -g
npm install expo-cli --g

Installation

1. Clone the repo

   git clone git@github.com:zoe/covid-tracker-react-native.git

2. When you first start your application you should see the IP address in the console (located above the QR code). For example:

   exp://123.456.7.890:19000

   Copy the host part of the IP address only.

3. Create a .env file - please note that http:// is required otherwise API requests will fail.

   echo "API_URL=http://<ip_address_host_here>:3000" > .env

   e.g.

   echo "API_URL=http://123.456.7.890:3000" > .env

4. Create an empty ./google-services.json file in the root of the application.

   echo "{}" > google-services.json

5. Run the following commands

   npm install
   expo start

6. Run the mock server

   npm run mock-server

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated - see the contributing guidelines.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Common Issues

These are some known, common issues and their solutions:

1. Changes to .env don't get picked up.

• Solution: Change some of the source code.

License

Distributed under the Apache 2.0 License. See LICENSE for more information.

Contact

ZOE Engineering - engineering@joinzoe.com

Acknowledgements

• Contributor Covenant