On this page ⌄
Adoption pathways
Adoption models and integration patterns for health ministries, digital health entrepreneurs, and enterprise architects.
Flexible adoption for diverse digital health needs
Open Health Stack is designed to accommodate different digital health contexts, from national ministry programmes to agile technology startups. Rather than imposing a single monolithic architecture, the ecosystem provides distinct pathways that allow teams to adopt specific components or deploy complete reference systems.
Pathway A for unbundled SDK and client adoption
Engineering teams with established mobile, web, or backend applications can adopt individual Open Health Stack libraries without adopting the full reference stack.
- Kotlin FHIR and FHIRPath provide type-safe FHIR data models and clinical logic evaluation for any Kotlin Multiplatform project.
- Kotlin FHIR Engine provides local SQLite-based offline storage, typed search, and background synchronization against standard FHIR endpoints.
- Kotlin FHIR Data Capture renders structured clinical questionnaires with Jetpack Compose Multiplatform across Android, iOS, desktop, and web.
- Info Gateway and FHIR Data Pipes provide reverse proxy authentication and batch analytical pipelines for backend infrastructure.
This pathway is ideal for organisations that already have a functioning clinical app and want to upgrade to multiplatform FHIR compliance or add robust offline sync.
Pathway B for reference platform adaptation
For national health authorities, non-governmental organisations, and digital health entrepreneurs building new platforms, the OHS Player reference composition provides an end-to-end baseline.
- Frontline mobile client app for community health workers and nurses
- Web administration portal for managing users, roles, organisations, and locations
- Reference gateway backend with authentication and custom access rules
- Reference analytics pipeline with automated SQL-on-FHIR extraction and Superset dashboards
- Complete Docker Compose reference infrastructure for local evaluation
Implementing teams fork the reference repositories, customize screen layouts via declarative FHIR resources, configure access rules, and deploy to their cloud or on-premise infrastructure.
Pathway C for analytics and interoperability hubs
Health systems often possess substantial transactional FHIR data but lack accessible analytical reporting for programme managers and epidemiologists.
In this pathway, organisations deploy FHIR Data Pipes alongside existing FHIR servers. The pipeline streams transactional FHIR resources into analytical PostgreSQL, BigQuery, or ClickHouse data warehouses using standard SQL-on-FHIR view definitions. Programme directors can query tabular health indicators and visualize trends in Apache Superset without impacting operational clinic servers.
Pathway D for artificial intelligence tooling and evaluation
Builders and health tech startups developing clinical intelligence or decision support tools can leverage AI Commons.
- Structured FHIR data modeling tools to translate unstructured clinical notes into compliant resources
- Standardized benchmarking suites to test artificial intelligence accuracy against clinical reference datasets
- Evaluation frameworks to measure safety, hallucination rates, and protocol adherence before deployment
This pathway enables teams to deploy artificial intelligence safely, with full auditability and clinical governance.
Pathway E for coexistence with national health infrastructure
Open Health Stack is designed to be complementary to existing digital health investments. Where standard FHIR APIs are available, interoperability works out of the box without requiring replacement of national software.
| Existing national component | How Open Health Stack integrates |
|---|---|
| Standard FHIR health systems | Direct resource synchronization and REST querying out of the box |
| DHIS2 national aggregate reporting | FHIR Data Pipes flattens encounters into indicator tables, and workflow tools like OpenFn submit monthly payloads |
| OpenMRS or hospital EHRs | Info Gateway routes client synchronization requests directly to standard FHIR module endpoints |
| National Master Patient Index | Gateway authentication plugins verify and map patient identifiers across regional health registries |
| Keycloak or enterprise IAM | Unified OpenID Connect and OAuth2 single sign-on across mobile apps and web portals |
How to choose your pathway
| If your primary goal is to | Recommended pathway | Where to start |
|---|---|---|
| Add offline FHIR storage to an existing mobile app | Pathway A (Client SDKs) | Kotlin FHIR Engine |
| Launch a complete community health solution | Pathway B (OHS Player) | Get started with Player |
| Generate aggregate reports from FHIR databases | Pathway C (Analytics Hub) | Reference Analytics |
| Validate clinical artificial intelligence safety | Pathway D (AI Commons) | AI Commons overview |
| Connect mobile workers to an existing national EHR | Pathway E (Coexistence) | The architecture |
| Explore reference solution architectures | Solution Architecture Samples | Architecture samples and use cases |