https://github.com/opensrp/fhircore
FHIR Core / OpenSRP 2 is a Kotlin application for delivering offline-capable, mobile-first healthcare project implementations from local community to national and international scale using FHIR and WHO Smart Guidelines on Android.
https://github.com/opensrp/fhircore
android android-fhir-sdk android-library fhir fhir-client fhircore hapi-fhir healthcare java kotlin kotlin-android kotlin-library opensrp opensrp-web
Last synced: 15 days ago
JSON representation
FHIR Core / OpenSRP 2 is a Kotlin application for delivering offline-capable, mobile-first healthcare project implementations from local community to national and international scale using FHIR and WHO Smart Guidelines on Android.
- Host: GitHub
- URL: https://github.com/opensrp/fhircore
- Owner: opensrp
- License: apache-2.0
- Created: 2021-02-16T00:15:15.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2026-01-26T13:55:47.000Z (28 days ago)
- Last Synced: 2026-01-27T02:58:57.430Z (28 days ago)
- Topics: android, android-fhir-sdk, android-library, fhir, fhir-client, fhircore, hapi-fhir, healthcare, java, kotlin, kotlin-android, kotlin-library, opensrp, opensrp-web
- Language: Kotlin
- Homepage: https://opensrp.io
- Size: 206 MB
- Stars: 68
- Watchers: 42
- Forks: 73
- Open Issues: 198
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/opensrp/fhircore/actions/workflows/ci.yml?query=branch%3Amain)
[](https://codecov.io/gh/opensrp/fhircore)
[](https://opensource.org/licenses/Apache-2.0)
[](https://chat.fhir.org/#narrow/stream/370552-OpenSRP)
[](https://join.slack.com/t/opensrp/shared_invite/zt-1xvw5fsjo-5RPlKqHmpU57SumJavgCzA)
# OpenSRP FHIR Core
FHIR Core is a Kotlin application for delivering offline-capable, mobile-first healthcare project implementations from local community to national and international scale using FHIR and the WHO Smart Guidelines on Android.
FHIR Core is architected as a FHIR native digital health platform powered by Google's [Android FHIR SDK](https://github.com/google/android-fhir) and [HAPI FHIR](https://hapifhir.io/). FHIR Core's user experience and module oriented design are based on over a decade of real world experience implementing digital health projects with [OpenSRP](https://smartregister.org/). This repository contains the Android mobile application built to:
- load configuration data as FHIR resources,
- support the WHO Smart Guidelines,
- manage the identities of healthcare workers (HCWs), community health workers (CHWs), care teams, patients, and clients,
- collect, view, and edit healthcare data with dynamic forms using FHIR's [Structured Data Capture](https://hl7.org/fhir/us/sdc/index.html) (SDC) implementation,
- securely store healthcare data encrypted at rest and securely transmit healthcare data using TLS,
- manage location hierarchies defined by community to national and international administrative boundaries.
For remote data storage and login, the mobile application requires:
- a [Keycloak](https://www.keycloak.org/) server to manage identity, authentication, and authorization;
- a [HAPI FHIR](https://hapifhir.io/) server to store operation and configuration data that includes the [HAPI FHIR to Keycloak integration](https://github.com/opensrp/hapi-fhir-keycloak).
FHIRcore also interoperates well with:
- [OpenSRP Web](https://github.com/OpenSRP/web) to access healthcare data from the same HAPI FHIR server.
## Getting Started
Due to it's dependency on the Android FHIR SDK's workflow library, OpenSRP FHIR Core requires a minimum Android SDK version of Android 8.0 (API level 26).
This repository contains the folders
* **[android](android)**: for building the Android application.
* **[docs](docs)**: a library of documents describing the FHIR Core solution.
We recommend reviewing the [docs](https://docs.smartregister.org/) before setting up the Android Studio Project in the [android](android) folder.
For starter resources on the FHIR specification:
1. [Intro to FHIR](https://youtu.be/YbQcJj1GqH0) - By James Agnew of Smile CDR
1. [FHIR resource list](http://hl7.org/fhir/resourcelist.html)
For starter resources on the Android FHIR SDK and this repo:
1. Android FHIR SDK Demo - [Link](https://drive.google.com/file/d/1ORjk3pNOKjGyZlbayAViPy4xkI8p-aFB/view?usp=sharing)
1. Android FHIR SDK Intro Slide deck - [Link](https://docs.google.com/presentation/d/1oc6EBJAcXsBwyBgtnra61xoM7naBF0aj8WbfrUT7Y2A)
1. FHIR Core Intro slide deck - [Link](https://docs.google.com/presentation/d/1eFsf9a5dcNqKXlfsEWyNZyoVooIbK3jq6694xarARr8)