---
title: Install Sahha SDK for Ionic Capacitor
---


Set up your platform projects and add the Sahha SDK to your Ionic Capacitor app.

---

## Prerequisites

{% callout title="Your project must support:" %}

- **iOS:** iOS 15 or above, Swift 5 or above
- **Android:** compileSdk 36 or above, Kotlin 1.9.24 or above — see [full Android requirements](/docs/connect/sdk/installation/android#prerequisites)

{% /callout %}

---

## Set Up Platform Projects

Ionic Capacitor apps target both iOS and Android, so you need to complete the platform-specific setup for each. These guides cover Xcode capabilities, manifest permissions, and everything your project needs before the SDK can collect health data.

{% action-cards %}

{% action-card title="iOS Platform Setup" icon="apple-logo" href="/docs/connect/sdk/installation/ios#set-up-xcode-project" description="Enable HealthKit, background delivery, background processing, and add usage descriptions in Xcode" /%}

{% action-card title="Android Platform Setup" icon="android-logo" href="/docs/connect/sdk/installation/android#set-up-android-project" description="Add Health Connect permissions to your AndroidManifest.xml" /%}

{% /action-cards %}

---

## Install the Library

Install the `sahha-capacitor` package from npm:

[View Sahha Capacitor SDK on npm](https://www.npmjs.com/package/sahha-capacitor)

```shell-session title="Terminal"
$ npm i sahha-capacitor
```

### Install the native iOS pod

{% callout title="Install CocoaPods" %}

You need CocoaPods to install the native iOS library. Visit [CocoaPods](https://cocoapods.org/) to install it if you don't have it yet.

{% /callout %}

```shell-session title="Terminal"
$ cd ios && pod install && cd ..
```

---

## Import the Module

Import Sahha in any file where you use the SDK:

```javascript title="app.js"
import { Sahha, SahhaEnvironment, SahhaSensor } from 'sahha-capacitor';
```

---

## Next Steps

Continue to [Step 2) Configure Settings](/docs/connect/sdk/configuration) to set your environment and notification preferences.