# sunnylqm/react-native-storage

local storage wrapper for both react-native and browser. Support size controlling, auto expiring, remote data auto syncing and getting batch data in one query.

Repository: https://github.com/sunnylqm/react-native-storage
Canonical: https://ross.abutalabs.com/products/react-native-storage
Language: JavaScript
License: MIT
License Family: permissive
Topics: localstorage, asyncstorage, react-native, reactjs, sync
Last push: 2026-07-19T09:13:42+00:00

## Health v2 (maintenance only)
Score: 74/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 93, release rhythm 35, longevity 100
- inputs: {"age_days": 4055, "days_push": 45, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3038, forks 264 (observed 2026-08-28T04:07:39.175273+00:00)

## What it is
A local storage wrapper library for React Native (AsyncStorage) and web apps (localStorage), offering size control, auto-expiring entries, remote data auto-sync, and batch loading. It uses ES6 syntax and promise-based async APIs.

## Use cases
- persist login state and tokens in a react native app
- cache api responses locally with auto expiry
- share a unified storage api between react native and web
- auto-sync expired local data from a remote server in the background
- store and retrieve batched key-value data in one query
- limit local storage size with automatic eviction of old entries

## When to choose
- you need a cross-platform key-value storage layer for react native and web
- you want built-in expiration and background sync of cached data
- you need memory caching on top of AsyncStorage or localStorage

## When to avoid
- starting a new project - the readme itself recommends TanStack Query with createAsyncStoragePersister instead
- you need structured queries or relational data rather than key-value storage
- you need storage for non-JavaScript platforms

## Facets
- artifact type: library
- maturity: maintenance
- function: caching, file-system
- domain: mobile-development, frontend, web-development, databases
- platform: browser
- tags: asyncstorage, localstorage, react-native, data-persistence, offline-storage, reactjs, javascript, nodejs

## Member repositories
- sunnylqm/react-native-storage (main) score 74

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:39.175273+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:29:17.014246+00:00, confidence not recorded.
  - readme: https://github.com/sunnylqm/react-native-storage (fetched 2026-08-28T04:07:39.175273+00:00, sha a8f8fa4eaf0b)
  - registry_npm: https://registry.npmjs.org/react-native-storage (fetched 2026-08-29T09:44:40.511969+00:00, sha 49e8de7270b8)
- Data as of 2026-08-30T08:39:29.467469+00:00.