Rakning C-19 is an app that can be downloaded voluntarily and facilitates the contact tracing process amidst the ongoing Covid-19 pandemic in Iceland.
With the user's consent the app keeps their location data. In case the contact tracing team of the Department of Civil Protection and Emergency Management needs to track someone's movements, they will be asked to upload their location data.
This would allow for the tracing team to help retrace a user's movements for the last two weeks and increase the likelihood of identifying individuals you might have been in contact with.
Make sure you have a Node 12+ and Yarn set up on your machine.
Then go to the React Native Environment Setup page, click the React Native CLI Quickstart
tab, then select your Development OS
and Target OS
to get a detailed guide to configure your machine for app development.
Finally, install the project dependencies:
yarn install
yarn ios
or:
You need XCode and an Apple developer account to run this on device.
If you get this error when building the project for iOS:
error: /Users/pedroteixeira/projects/rakning-c19-app/ios/Pods/Target Support Files/Pods-Rakning/Pods-Rakning.debug.xcconfig: unable to open file (in target "Rakning" in project "Rakning") (in target 'Rakning' from project 'Rakning')
Try running yarn prepare
, which should fix this issue.
For other CocoaPods issues, it sometimes helps to go into the ios
folder and run:
pod install --repo-update
Have an Android emulator running (quickest way to get started), or a device connected. Then run:
yarn android
There are now three ways to get this app:
Never install the app from places not listed here or on covid.is, since they can be spreading a modified version of the app which could compromise your privacy and security.
It authenticates users with their phone number. It stores the user's phone number, their locale and push notification token on the server.
Then the app requests permission to track the user's location in the background. Geolocation updates are then stored on-device in a SQLite database.
When the backend receives a request for data, it marks the user for data collection and triggers a push notification.
Next time the user opens the app, it checks if there's a data request and allows the user to approve the request before sending 14 days of geolocation data to the backend.
For more information, check out the System Architecture.
Rakning C-19 uses a React Native plugin called React Native Background Geolocation. Behind the scenes, it calls different APIs on Android and iOS to get geolocation updates, even when you don't have the application opens.
These geolocation updates are stored in an SQLite database that the plugin manages.
The logic is in src/tracking.js
.
Only after the user explicitly approves a data collection request.
The logic is in src/router/logged-in/screens/RequestDataScreen.js
.
The app is now open source under the MIT License. There are three main reasons:
Please help us improve the app for all.
We're still evaluating if/how we want to open source the API.
The project is a private initiative developed in a close collaboration with the Icelandic Directorate of Health and the Department of Civil Protection and Emergency Management.
It was produced by Aranja, Decode, Kolibri, Samsyn, Sensa and Stokkur.
The project was made better with consulting from Digido, Magga Dóra, Svavar Ingi Hermannsson and Syndis.
All respective parties gave their work to this project.
We'll gladly accept contributions. Check out the issues for places to start.
We have reviewed the code multiple time and received security audits from third party vendors. However, there is no such thing as 100% security.
If you believe you’ve found a security vulnerability, please send it to us by emailing security@aranja.com. Please include the following details with your report:
Please practice Responsible Disclosure and give us sufficient time to deploy a fix to our users.