From 4799ea4f093e6a48acc22366f59944081ad82d27 Mon Sep 17 00:00:00 2001
From: Michel Weststrate <mweststrate@fb.com>
Date: Wed, 3 Mar 2021 06:46:21 -0800
Subject: [PATCH] Documented how to opt out from flipper on iOS

Summary: More docs. Addresses https://github.com/facebook/flipper/issues/1326, https://github.com/facebook/flipper/issues/1215 and probably more

Reviewed By: jknoxville

Differential Revision: D26778514

fbshipit-source-id: dcadbad8f53f483d14e7fc54199756a697095309
---
 docs/troubleshooting.mdx | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/docs/troubleshooting.mdx b/docs/troubleshooting.mdx
index d44d5cd44..3b9e9b06c 100644
--- a/docs/troubleshooting.mdx
+++ b/docs/troubleshooting.mdx
@@ -201,3 +201,27 @@ If you experience errors such as `Undefined symbol: associated type descriptor f
    <img alt="Screenshot showing the places mentioned in the last steps" src={useBaseUrl("img/troubleshooting-react-native-ios-swift-2.png")} />
 
 1. Now you can run your build normally.
+
+#### Opting out from flipper (iOS)
+
+Comment out the relevant lines in `ios/Podfile` and run `cd ios && pod install` again:
+
+```
+  # use_flipper!
+  # post_install do |installer|
+  #  flipper_post_install(installer)
+  # end
+```  
+
+#### Disable Flipper on CI builds (iOS)
+
+To speed up CI builds, Flipper can be disabled on CI environments by making the Flipper SDK inclusion conditional (this works on most CI providers, feel free to customize the environment variable):
+
+```
+  if !ENV['CI']
+    use_flipper!
+    post_install do |installer|
+      flipper_post_install(installer)
+    end
+  end
+```