# @react-native-async-storage/async-storage

> Asynchronous, persistent, key-value storage system for React Native.

Latest version **3.1.1** (published 2026-05-29) · MIT license · 0 weekly downloads

## Install

```sh
npm install @react-native-async-storage/async-storage
pnpm add @react-native-async-storage/async-storage
yarn add @react-native-async-storage/async-storage
bun add @react-native-async-storage/async-storage
```

## Health

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

Positive: has types; esm support; no vulnerabilities; has provenance; high maintenance score.

Warnings: low downloads; large bundle.

## Facts

| | |
|---|---|
| Version | 3.1.1 |
| Published | 2026-05-29 |
| First published | 2020-10-21 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 1 |
| Unpacked size | 49.5 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 5074 |
| Author | Krzysztof Borowy |
| Maintainers | krizzu |
| Keywords | react-native, react native, async storage, asyncstorage, storage |

## Links

- npm: https://www.npmjs.com/package/@react-native-async-storage/async-storage
- Repository: https://github.com/react-native-async-storage/async-storage
- Homepage: https://github.com/react-native-async-storage/async-storage#readme
- Issues: https://github.com/react-native-async-storage/async-storage/issues
- npm.io page: https://npm.io/package/@react-native-async-storage/async-storage

## Dependencies (1)

- [idb](https://npm.io/package/idb.md) 8.0.3

## Alternatives

- [localforage](https://npm.io/package/localforage.md) — 6.2M weekly downloads
- [localforage-observable](https://npm.io/package/localforage-observable.md) — 30.8K weekly downloads
- [@y/y](https://npm.io/package/@y/y.md) — 30.1K weekly downloads
- [@metaobjectsdev/render](https://npm.io/package/@metaobjectsdev/render.md) — 3.5K weekly downloads
- [@ledgerhq/coin-algorand](https://npm.io/package/@ledgerhq/coin-algorand.md) — 1.1K weekly downloads

## Recent versions

- 3.1.1 (latest) — 2026-05-29
- 3.0.0-next.3 (next) — 2025-12-23
- 3.1.0 — 2026-05-21
- 3.0.3 — 2026-05-19
- 3.0.2 — 2026-03-26
- 3.0.1 — 2026-02-23
- 3.0.0 — 2026-02-23
- 3.0.0-next.2 — 2025-11-24
- 3.0.0-next.1 — 2025-11-22
- 3.0.0-next.0 — 2025-11-16
- 2.2.0 — 2025-06-05
- 2.1.2 — 2025-02-28
- 2.1.1 — 2025-02-03
- 2.1.0 — 2024-11-15
- 2.0.0 — 2024-08-22
- … 63 more at https://npm.io/package/@react-native-async-storage/async-storage/versions

## README

# React Native Async Storage

Async Storage is an asynchronous, unencrypted, persistent key-value storage solution for your React Native application.
It provides a simple API compatible with
the [Web Storage API](https://developer.mozilla.org/en-US/docs/Web/API/Web_Storage_API), with additional extensions for
batch operations and multi-database support.

## Supported platforms

- **Android** (SQLite)
- **iOS** (SQLite)
- **macOS** (SQLite)
- **visionOS** (legacy fallback, single database only)
- **Web** (IndexedDB backend)
- **Windows** (legacy fallback, single database only)

## Compatibility

Compatibility table for React Native:

| React Native | Minimum Version |
| ------------ | --------------- |
| ios/android  | 0.76            |
| macOS        | 0.78            |
| visionOS     | 0.79            |
| windows      | 0.79            |

Other components:

| Component        | Version |
| ---------------- | ------- |
| kotlin           | 2.1.0   |
| android min sdk  | 24      |
| ios min target   | 13      |
| macOS min target | 12      |

---

## Installation

```shell
# Using npm
npm install @react-native-async-storage/async-storage

# Using yarn
yarn add @react-native-async-storage/async-storage
```

### iOS/macOS

Install cocoapods dependencies:

```shell
# inside macos/ios directory
pod install
```

## Usage

```typescript
import { createAsyncStorage } from "@react-native-async-storage/async-storage";

// create a storage instance
const storage = createAsyncStorage("appDB");

async function demo() {
  await storage.setItem("userToken", "abc123");

  const token = await storage.getItem("userToken");
  console.log("Stored token:", token); // abc123

  await storage.removeItem("userToken");
}
```

## License

MIT

---
_Source: https://npm.io/package/@react-native-async-storage/async-storage · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._