react-native-async-storage/async-storage

An asynchronous, persistent, key-value storage system for React Native.

5,072

stars

492

commits

Kotlin

primary language

Sep 5, 2026

updated

react-native-async-storage.github.io

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, 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

# 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:

# inside macos/ios directory
pod install

Usage

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

Contributors

(top 30 of 138)

94 commits

93 commits

48 commits

35 commits

Similar repos

Tencent/MMKV

An efficient, small mobile key-value storage framework developed by WeChat. Works on Android, iOS,…

18,732

similar language mix

wix/react-native-navigation

A complete native navigation solution for React Native

13,177

similar language mix

localForage/localForage

💾 Offline storage, improved. Wraps IndexedDB, WebSQL, or localStorage using a simple but powerful…

25,811

jakearchibald/idb-keyval

A super-simple-small promise-based keyval store implemented with IndexedDB

3,238

software-mansion/react-native-screens

Native navigation primitives for your React Native app.

3,726

similar language mix

facebook/react-native

A framework for building native applications using React

126,558

shared contributors

react/react-native

A framework for building native applications using React

126,558

shared contributors

software-mansion-labs/react-native-enriched-markdown

Multiplatform Markdown-Based Rich Text Solution

1,021

similar language mix

Languages

Kotlin

27.4%

C++

25.6%

Objective-C++

21.0%

TypeScript

18.4%

Swift

3.3%

Shell

1.3%

Objective-C

1.2%

react-native-async-storage/async-storage

An asynchronous, persistent, key-value storage system for React Native.

5,072

stars

492

commits

Kotlin

primary language

Sep 5, 2026

updated

react-native-async-storage.github.io

README

React Native Async Storage

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

# 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:

# inside macos/ios directory
pod install

Usage

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");
}