From ddd9536e142211cdc39549b5d4a51c9f965d1b13 Mon Sep 17 00:00:00 2001
From: Michel Weststrate <mweststrate@fb.com>
Date: Mon, 4 Jan 2021 12:15:49 -0800
Subject: [PATCH] Add more explicit notes on how to update the Flipper SDK in
 react-native

Summary: Per title

Reviewed By: passy

Differential Revision: D25756219

fbshipit-source-id: c1620cc7dda0195965a697a75db836b2057be3e9
---
 docs/getting-started/react-native.mdx | 14 +++++++++++++-
 docs/troubleshooting.mdx              |  2 ++
 2 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/docs/getting-started/react-native.mdx b/docs/getting-started/react-native.mdx
index 10dd318b2..31e4356b9 100644
--- a/docs/getting-started/react-native.mdx
+++ b/docs/getting-started/react-native.mdx
@@ -26,7 +26,19 @@ Additional plugins can be installed through the plugin manager.
 
 To create your own plugins and integrate with Flipper using JavaScript, check out our <Link to={useBaseUrl("/docs/tutorial/react-native")}>writing plugins for React Native</Link> tutorial!
 
-To update the Flipper SDK in your project, you bump the version in the `ios/Podfile` and `android/gradle.properties` files of your project.
+### Using the latest Flipper SDK
+
+By default React Native might ship with an outdated Flipper SDK. To make sure you are using the latest version, determine the latest released version of Flipper by running `npm info flipper`.
+
+Android:
+
+1. Bump the `FLIPPER_VERSION` variable in `android/gradle.properties`, for example: `FLIPPER_VERSION=0.69.0`.
+2. Run `./gradlew clean` in the `android` directory.
+
+iOS:
+
+1. Call `use_flipper` with a specific version in `ios/Podfile`, for example: `use_flipper!({ 'Flipper' => '0.69.0' })`.
+2. Run `pod install` in the `ios` directory.
 
 ## Manual Setup
 
diff --git a/docs/troubleshooting.mdx b/docs/troubleshooting.mdx
index 13e252ae4..fefaa4fac 100644
--- a/docs/troubleshooting.mdx
+++ b/docs/troubleshooting.mdx
@@ -106,6 +106,8 @@ debugImplementation('com.facebook.flipper:flipper:*') {
 
 ## React Native
 
+Make sure the project is using the [latest Flipper SDK](getting-started/react-native#using-the-latest-flipper-sdk). 
+
 When using Flipper with React Native, two devices should show up:
 
 1. The 'React Native' device. This is the "device" that talks to the Metro server and shows plugins that connect to or through Metro, such as the React DevTools, the Hermes Debugger and Metro logs.