# @dhis2/app-runtime

> A singular runtime dependency for applications on the DHIS2 platform

Latest version **3.17.5** (published 2026-11-09) · BSD-3-Clause license · 0 weekly downloads

## Install

```sh
npm install @dhis2/app-runtime
pnpm add @dhis2/app-runtime
yarn add @dhis2/app-runtime
bun add @dhis2/app-runtime
```

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 3.17.5 |
| Published | 2026-11-09 |
| First published | 2019-04-09 |
| Weekly downloads | 0 |
| License | BSD-3-Clause |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 7 |
| Unpacked size | 13.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 16 |
| Author | Austin McGee |
| Maintainers | dhis2-bot, amcgee |

## Links

- npm: https://www.npmjs.com/package/@dhis2/app-runtime
- Repository: https://github.com/dhis2/app-runtime
- Homepage: https://github.com/dhis2/app-runtime#readme
- Issues: https://github.com/dhis2/app-runtime/issues
- npm.io page: https://npm.io/package/@dhis2/app-runtime

## Dependencies (7)

- [prop-types](https://npm.io/package/prop-types.md) ^15.7.2
- [@dhis2/app-service-data](https://npm.io/package/@dhis2/app-service-data.md) 3.17.5
- [@dhis2/app-service-user](https://npm.io/package/@dhis2/app-service-user.md) 3.17.5
- [@dhis2/app-service-alerts](https://npm.io/package/@dhis2/app-service-alerts.md) 3.17.5
- [@dhis2/app-service-config](https://npm.io/package/@dhis2/app-service-config.md) 3.17.5
- [@dhis2/app-service-plugin](https://npm.io/package/@dhis2/app-service-plugin.md) 3.17.5
- [@dhis2/app-service-offline](https://npm.io/package/@dhis2/app-service-offline.md) 3.17.5

## Recent versions

- 3.17.5 (latest) — 2026-11-09
- 3.18.0-beta.2 (beta) — 2026-06-10
- 3.12.0-alpha.2 (alpha) — 2024-12-03
- 2.12.4 (release-2.x) — 2021-10-20
- 2.10.0-pwa.4 (pwa) — 2021-08-31
- 3.17.4 — 2026-08-23
- 3.17.3 — 2026-06-23
- 3.17.2 — 2026-06-18
- 3.17.1 — 2026-06-14
- 3.18.0-beta.1 — 2026-06-09
- 3.17.0 — 2026-04-16
- 3.17.0-beta.4 — 2026-04-16
- 3.17.0-beta.3 — 2026-04-15
- 3.17.0-beta.2 — 2026-02-11
- 3.17.0-beta.1 — 2026-02-11
- … 126 more at https://npm.io/package/@dhis2/app-runtime/versions

## README

# DHIS2 Application Runtime

A singular runtime dependency for applications on the DHIS2 platform

## Installation

```sh
yarn add @dhis2/app-runtime
```

**NB** Please ensure that all webpack bundles reference the same Context, you can do this by adding `@dhis2/app-runtime` to `peerDependencies` (rather than `dependencies`) and webpack `externals` for _library_ builds. Top-level web applications should be able to include the dependency directly

This library uses the official React Context API (introduced in 16.3) and React Hooks (introduced in 16.8), so **React >= 16.8 is required** to use it

## Required Polyfills

The following must be polyfilled to support older and non-compliant browsers (i.e. IE11):

- es6.promise (i.e. [core-js/features/promise](https://github.com/zloirock/core-js))
- window.fetch (i.e. [whatwg-fetch](https://github.com/github/fetch))
- AbortController / AbortSignal (i.e. [abortcontroller-polyfill](https://www.npmjs.com/package/abortcontroller-polyfill))

## Usage

See [the docs](https://developers.dhis2.org/docs/app-runtime/getting-started) for usage and examples

---
_Source: https://npm.io/package/@dhis2/app-runtime · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._