GithubHelp home page GithubHelp logo

LetsTrace Android and iOS build on MacOS

Help us stop COVID-19.


LetsTrace relies on Private Kit - a ‘privacy-first’ app that allows you to log your GPS trails on your own phone. The information is stored locally and never shared with anyone (not even with us or MIT) until you explicitly decide to manually export the data. The location log generated by Private Kit cannot be accessed from outside the user’s device. Location information can be imported and exported by the user and used in other projects and applications.

Private Kit’s trail generator logs your device’s location once every five minutes and stores 28 days of data in under 100KB of space – less space than a single picture. But what is truly exciting about Private Kit is its privacy protection.

Homepage: https://privatekit.mit.edu

WhitePaper: Apps Gone Rogue: Maintaining Personal Privacy in an Epidemic

Architecture

This is a React Native app, supporting both iOS and Android.

The diagram in docs/Private-Kit-Diagram.png has an overview of the events and services.

Development environment

First, install Node dependencies:

npm install

iOS

To set up your environment, go to the React Native development environment docs, select "React Native CLI Quickstart", select "iOS" under target OS, then follow the instructions under "Installing dependencies".

Next, run:

cd ios/
pod install
cd ..

To run the app:

npx react-native run-ios

Android

To set up your environment, go to the React Native development environment docs, select "React Native CLI Quickstart", select "Android" under target OS, then follow the instructions under "Installing dependencies".

You'll also need to follow the instructions under "Using a virtual device" if you want to use the simulator to run the app.

To run the app:

npx react-native run-android

Google Maps API Key

You will need to generate a Google API key in order for the mapping features to work correctly. Refer to this guide guide in order to create the API key.

Once created you will need to add it to two different places in the project. One for Android and one for iOS.

  • Android - open android/app/src/main/AndroidManifest.xmland search for com.google.android.geo.API_KEY. Add your key to the android:value property.
  • iOS - open ios/PrivateKit/AppDelegate.m and search for GMSServices provideAPIKey and replace line with [GMSServices provideAPIKey:@"YOUR_API_KEY"];

Troubleshooting

  • If you have any trouble with packages not found, try react-native link from project directory.
  • If you see the error Failed to load bundle - Could not connect to development server, kill all other react-native processes and try it again.

letstrace's Projects

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.