swr-react-native

Add React Native/React Navigation compatibility to swr. 👨🏻‍🔧

Usage no npm install needed!

<script type="module">
  import swrReactNative from 'https://cdn.skypack.dev/swr-react-native';
</script>

README

SWR + React Native 🐮

Add React Native/React Navigation compatibility to swr. 👨🏻‍🔧

- import useSWR from 'swr'
+ import useSWRNative from '@nandorojo/swr-react-native'

That's all. SWR revalidation now works in your React Native app. Requests also revalidate when your React Navigation screens focus.

Why?

swr is an awesome data fetching + caching library by Vercel.

However, some of its essential features, such as revalidateOnFocus & revalidateOnConnect, don't work on React Native.

This library provides a simple drop-in replacement for useSWR, which adds compatibility for React Native / React Navigation.

It comes with 2 hooks: useSWRNative, and useSWRNativeRevalidate.

Features

  • Adds support for revalidateOnConnect & revalidateOnFocus.
  • Configurable focusEventThrottle
  • Web, iOS and Android compatibility.
  • Zero config
  • Works with React Navigation

Installation

yarn add @nandorojo/swr-react-native

Next, install peer dependencies:

# if you're using expo
expo install @react-native-community/netinfo

# if you aren't using expo
yarn add @react-native-community/netinfo

Usage

There are 2 ways to use this library:

1. Simplest usage

Replace imports of useSWR with useSWRNative. That's it!

import useSWRNative from '@nandorojo/swr-react-native'

const { data, mutate, error } = useSWRNative(key, fetcher, config)

2. Custom usage

If, for some reason, you don't want to replace your imports, you can use the useSWRNativeRevalidate hook.

This option exists in case useSWR makes some big changes to their API or something down the line.

import { useSWRNativeRevalidate } from '@nandorojo/swr-react-native'

Call useSWRNativeRevalidate, likely below your useSWR function:

const { data, revalidate } = useSWR(key, fetcher)

useSWRNative({
  // required: pass your revalidate function returned by SWR
  revalidate

  // optional, defaults copied from SWR
  revalidateOnFocus: true,
  revalidateOnReconnect: true,
  focusThrottleInterval: 5000,
})

The revalidate function is required!

Context

The idea for this library originated from this issue.

I'm a big fan of SWR. I've also built a fetching library for Firebase/Firestore based on swr, which you can find here.

It's still pretty new, and isn't super battle tested, so I'd appreciate help testing it.