Skip to content

Repository files navigation

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 NativeMinimum Version
ios/android0.76
macOS0.78
visionOS0.79
windows0.79

Other components:

ComponentVersion
kotlin2.1.0
android min sdk24
ios min target13
macOS min target12

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 instanceconststorage=createAsyncStorage("appDB");asyncfunctiondemo(){awaitstorage.setItem("userToken","abc123");consttoken=awaitstorage.getItem("userToken");console.log("Stored token:",token);// abc123awaitstorage.removeItem("userToken");}

License

MIT

About

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

Resources

Contributing

Stars

5.1k stars

Watchers

31 watching

Forks

Releases

Packages

Used by

Contributors

Languages