react-native-async-storage/async-storage
Async Storage
React Native AsyncStorage is a persistent key-value storage library designed for React Native applications. It provides a unified local storage interface that works identically on both iOS and Android, ensuring saved data remains available across app restarts and when the device has no network connectivity.
The library uses an asynchronous background I/O queue to handle all storage operations without blocking the JavaScript thread, communicating with native storage engines through React Native's bridge protocol. It includes a serialization layer that converts JavaScript values to strings for storage and restores them on retrieval, along with an in-memory LRU cache that reduces disk reads while maintaining consistency through write-based invalidation. A multi-engine storage adapter abstracts platform-specific persistence backends, enabling flexible backend selection at initialization.
The library covers the full range of local storage tasks: storing, reading, and removing key-value pairs, with persistence that survives app restarts and supports offline data availability. Common use cases include preserving app state, caching frequently accessed data, and storing user preferences like theme or language settings.
Features
- React Native Libraries - Provides persistent key-value storage for React Native applications across iOS and Android.
- Native Module Bridges - Communicates with native storage engines asynchronously via React Native's bridge protocol.
- Cross-Platform Storage Frameworks - Provides a unified key-value storage API that works identically on both iOS and Android.
- Key-Value Persistence Stores - Stores key-value pairs in local storage so they remain available after the app restarts.
- Key-Value Stores - Retrieves stored values by key from local storage for use anywhere in the application.
- Key Deletion - Removes specific key-value pairs from local storage when they are no longer needed.
- Offline-First Persistence - Stores app data locally so it remains available when the device has no network connection.
- Background I/O Queues - Enqueues all storage operations on a background thread to prevent blocking the JavaScript thread.
- App Settings Persistence - Preserves user sessions, draft content, or app settings across restarts and app closures.
- Storage Backend Adapters - Abstracts platform-specific persistence backends behind a single AsyncStorage interface.
- Key-Value - Keeps frequently accessed data in local storage to reduce network requests and improve performance.
- Value Serializers - Converts JavaScript values to plain strings for storage and restores types on retrieval.
- In-Memory Cache Invalidations - Maintains an in-memory LRU cache of recent keys, invalidating entries on writes for consistency.
- User Preference Persistence - Stores user-chosen settings like theme, language, or notification preferences in a persistent key-value store.
