SMART Base
0.2.0 - ci-build

SMART Base, published by WHO. This guide is not an authorized publication; it is the continuous build for version 0.2.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/WorldHealthOrganization/smart-base/tree/main and changes regularly. See the Directory of published versions

Home

Official URL: http://smart.who.int/base/ImplementationGuide/smart.who.int.base Version: 0.2.0
Draft as of 2026-03-09 Computable Name: Base

Overview

WHO SMART Guidelines (Standards-based, Machine-readable, Adaptive, Requirements-based, and Testable) are a set of WHO clinical guidelines that have been transformed into a computable, interoperable format. They enable countries to rapidly adopt, adapt, and implement WHO recommendations within their digital health systems by providing structured, machine-readable clinical content.

A Digital Adaptation Kit (DAK) is the primary artefact of WHO SMART Guidelines. It is a structured, standardised package of clinical and operational content that represents a WHO health intervention in a computable form. Each DAK contains:

  • Health interventions and recommendations – the clinical guidance from WHO
  • Generic personas – representative end-users and actors in the health system
  • User scenarios – narrative descriptions of how the guidance is used in practice
  • Business processes and workflows – step-by-step care pathways
  • Core data elements – the data dictionary for the health domain
  • Decision-support logic – computable clinical decision rules
  • Functional and non-functional requirements – system capability requirements
  • Program indicators – aggregate measures and metrics for monitoring and evaluation
  • Test scenarios – structured tests to validate conformance

The diagram below illustrates the nine components of a WHO DAK and how they relate to one another:

WHO Digital Adaptation Kit – nine-component overview diagram
Figure 1 – The nine components of a WHO Digital Adaptation Kit (DAK)

This implementation guide contains base conformance resources for use in all WHO SMART Guidelines implementation guides.

See the SMART IG Starter Kit for more information on building and using WHO SMART Guidelines.

DAK (Digital Adaptation Kit) URL Handling

For repositories that contain a dak.json file in the root directory, this implementation guide provides enhanced URL handling for publication and preview scenarios:

Publication URLs

  • WHO Repositories: For repositories owned by WorldHealthOrganization, the publication URL follows the pattern https://smart.who.int/{stub} where {stub} is the repository name with any smart- prefix removed.
  • Other Repositories: Use the canonical URL specified in sushi-config.yaml or fall back to GitHub Pages pattern.

Preview URLs

  • All Repositories: Preview URLs use the GitHub Pages pattern https://{profile}.github.io/{repo} for current CI builds.

Branch-Based URL Selection

  • Release Branches (prefixed with release-): Use publication URLs for canonical references and resource identifiers.
  • Development Branches: Use preview URLs for canonical references and resource identifiers.

The DAK configuration is automatically regenerated during CI builds to ensure URLs are appropriate for the current branch context.

Dependencies

IGPackageFHIRComment
.. SMART Basesmart.who.int.base#0.2.0R4
... HL7 Terminology (THO)hl7.terminology#5.5.0R4
... FHIR Extensions Packhl7.fhir.uv.extensions.r4#5.1.0R4
... FHIR Extensions Packhl7.fhir.uv.extensions.r5#5.2.0R5
... Clinical Practice Guidelineshl7.fhir.uv.cpg#2.0.0R4For Decision Tables
... Canonical Resource Management Infrastructure Implementation Guidehl7.fhir.uv.crmi#1.0.0R4This IG uses content management profiles and capabilities provided by the Canonical Resource Management Infrastructure (CRMI) IG
... Structured Data Capturehl7.fhir.uv.sdc#3.0.0R4This IG uses questionnaire profiles and capabilities provided by the Structure Data Capture (SDC) IG
... FHIR Tooling Extensions IGhl7.fhir.uv.tools.r4#0.9.0R4for example references

Cross Version Analysis

This is an R4 IG. None of the features it uses are changed in R4B, so it can be used as is with R4B systems. Packages for both R4 (smart.who.int.base.r4) and R4B (smart.who.int.base.r4b) are available.

Global Profiles

There are no Global profiles defined

IP Statements

This publication includes IP covered under the following statements.