---
title: "Installation"
description: "Install the React Native packages, enable the New Architecture, and stage the native wallet runtime."
canonical: https://wavelength.lightning.engineering/react-native/get-started/installation/
---

> Docs index: https://wavelength.lightning.engineering/llms.txt

# Installation

## The packages

```sh
npm install @lightninglabs/wavelength-react-native @lightninglabs/wavelength-react
```

### @lightninglabs/wavelength-react-native

The native transport: a Turbo Module wrapping the wallet runtime compiled into your app binary. Re-exports the entire `core` surface, so it is the only wallet import an app needs besides the hooks package.

### @lightninglabs/wavelength-react

React provider and hooks. Transport-agnostic: it takes an injected client and depends only on `core`.

## New Architecture and Expo

This package is New Architecture only; it does not support the legacy architecture. Enable the New Architecture in your app before installing.

Expo apps need a **development build**, not Expo Go: the native wallet runtime is a compiled module that Expo Go cannot load. `npx expo run:android` and `npx expo run:ios` both produce development builds that include it.

## iOS pods

`pod install` runs as part of `expo run:ios` or a standard React Native build; you do not need to run it separately in the common case. If `pod install` fails with a locale-related error, set `LANG=en_US.UTF-8` before retrying.

## Native runtime binaries

> **Native binaries are not bundled**
>
> The native wallet runtime binaries (`Wavewalletdk.aar`, `Wavewalletdk.xcframework`) are not included in the npm package. Get them either from the paired [wavelength release](https://github.com/lightninglabs/wavelength/releases) or by building them from a `wavelength` checkout with the package’s `scripts/fetch-bindings.sh`, then stage them into the package before running `pod install` or a Gradle build.

## Next steps

- [Quickstart](/react-native/get-started/quickstart/): wire up the provider, create a wallet, and send your first payment.
- [Requirements](/react-native/get-started/requirements/): confirm the platform, OS, and passkey requirements.