1.0.0 • Public • Published

React Native Simple Store

Code Climate Build Status npm version npm

A minimalistic wrapper around React Native's AsyncStorage.

The react-native-simple-store is a good match for apps that are not using redux. If you have already found that your app needs to use redux and you need to persist data to the device it is recommended that you make use of redux-persist which provides a clean interface for storing data in your reducers to device.


npm install react-native-simple-store

Since this wrapper uses react-native-async-storage, it needs to be linked to work properly:

react-native link @react-native-community/async-storage

Use In Project

import store from 'react-native-simple-store';

API Reference

Example Usage

Working With Objects

React-native-simple-store allows you to easily store data by assigning it a unique key. We will show you a few examples of just how easy it is to get started.

Saving and Retrieval


// Update the object stored under the key 'album'. We will add a new property of 'albumName' to this object.
store.update('album', {
  albumName: 'Blurry Face'

// Get updated object
.then((res) =>
  console.log(res.albumName) // 'Blurry Face'

// Our object stored under the key 'album' now looks like this
artist: 'Twenty One Pilots',
  albumName: 'Blurry Face'

Working With Arrays

Arrays are easy to work with using react-native-simple-store's built-in "push" method. You can use the "push" method to create an array, or add data to the array. Behind the scene's react-native-simple-store will check if an array exists under the key you specified, if it does, it will add the new specified data to the existing array. If it does not exist, it will create the array for you.

Array Creation

// Save an array to the users device. We will give it the key 'shoppingList' for easy retrieval
store.push("shoppingList", "milk");

// ['milk'] is created and stored on the users device

Retrieval and Updating

// Get the array from the users device
  res => console.log(res) // ['milk']

// Add data to 'shoppingList'
store.push("shoppingList", "coffee");

// Retrieve new array
  res => console.log(res) // ['milk', 'coffee']

More "Advanced" Example

Instead of storing strings in an array like the above example, let's store objects. We will create a new array to store on the user's device named 'artists'.

const femaleArtist = {
  name: "Lady Gaga",
  age: 31,
  gender: "female"

const maleArtist = {
  name: "The Weeknd",
  age: 27,
  gender: "male"

// Creates a new array, and inserts this object into it.
store.push("artists", femaleArtist);
// Adds this new object to the end of the array.
store.push("artists", maleArtist);

// Our new array will look like this when we retrieve it
// [{
//   name: "Lady Gaga",
//   age: 31,
//   gender: "female"
// },
// {
//   name: "The Weeknd",
//   age: 27,
//   gender: "male"
// }];


You can chain these methods as much as you'd like, as well as catch errors. Here is a lengthy example for you to reference.

  .save("coffee", {
    isAwesome: true
  .then(() => store.get("coffee"))
  .then(coffee => {
    console.assert(coffee.isAwesome === true);
  .then(() =>
    store.update("coffee", {
      isNotEssential: false
  .then(() => store.get("coffee"))
  .then(coffee => {
    console.assert(coffee.isNotEssential === false);
    console.assert(coffee.isAwesome === true);
    return store.delete("coffee");
  .then(() => store.get("coffee"))
  .then(coffee => {
    console.assert(coffee === null);
  .catch(error => {

// using the .push method for storing arrays
  .save("coffeeTraits", ["rich"])
  .then(store.push("coffeeTraits", "smooth"))
  .then(console.log); // ['rich', 'smooth']

Deleting Data

Deleting the data on the user's device is just as easy. Just insert the key of the data you want to remove as the argument to the "delete" method, and you are done!

store.delete("album"); // Bye bye



Package Sidebar


npm i react-native-simple-store2

Weekly Downloads






Unpacked Size

12.8 kB

Total Files


Last publish


  • nageshempire