Intro to React Native »

Chapter 8: React Native Local Storage

We need to persist the favorites after the app re-launches, so we will use a local storage module to save the data.

Install AsyncStorage

The AsyncStorage is a basic key-value database for React Native. Because the module involves native code, Expo reccomends:

expo install @react-native-community/async-storage


AsyncStorage has two essential functions for storing and retreiving data. To store data, use setItem:

await AsyncStorage.setItem('message', 'hello!')

And to retreive that string we saved:

const message = await AsyncStorage.getItem('message')
if (message === null) {
  console.log('Could not find message!')
} else {

Store Integration

import AsyncStorage from "@react-native-community/async-storage";

let favorites = null;
const subscriptions = new Set();

const FAVS_STORAGE_KEY = "FavoriteCities-0";

  .then((result) => {
    if (data === null) {
      favorites = [];
    } else {
      const storedFavorites = JSON.parse(data);
      favorites = storedFavorites;
    subscriptions.forEach((handle) => {
  .catch((err) => {
    console.error("Could not load favorites", err);

function setFavorites(transaction) {
  favorites = transaction(favorites);
  subscriptions.forEach((handle) => {
  AsyncStorage.setItem(FAVS_STORAGE_KEY, JSON.stringify(favorites)).catch(
    (err) => {
      console.error("Could not write favorites", err);

Now even after our app restarts, we persist the favorite cities. Now that the city favorite feature is complete, we will move on to the map component to display our city's air sensors.

Next: Maps

© Aven LLC and Aven Contributors. Licensed under Creative Commons BY-NC-SA 4.0

Open Source under Apache 2.0