diff --git a/shared/docs/android/setup.md b/shared/docs/android/setup.md
index 12af8a5d3fbf..23e5fab6af11 100644
--- a/shared/docs/android/setup.md
+++ b/shared/docs/android/setup.md
@@ -12,7 +12,7 @@ You will already have the `sdkmanager` command line tool installed. So run:
 
 `sdkmanager --install "ndk-bundle"` which should write to `$HOME/Library/Android/sdk/ndk-bundle` on macOS.
 
-**Without Android Stuido** 
+**Without Android Studio**
 You will need the Android Studio Command Line Tools to use `sdkmanager` without Android Studio.
 [Download Command Line Tools](https://developer.android.com/studio/index.html#command-tools) here.
 
@@ -115,19 +115,11 @@ react-native packager running (`yarn rn-start android`).
 Then run
 
 ```sh
-# Build the apk.
-yarn rn-build-android
-
-# Or with gradle (inside android)
-# You can also use the gradle wrapper `./gradlew` in android
-gradle installDebug
-
+yarn react-native run-android
 
 # for storybook
-gradle installStorybook
+yarn react-native run-android --variant 'storybook'
 
-# gradle tasks shows all the things you can do with gradle
-gradle tasks
 ```
 
 Unless you're modifying the Java files or you're modifying Go files
@@ -196,21 +188,9 @@ To recap, you should have run:
 
 1. `adb devices` (should list _exactly_ one device)
 1. `yarn rn-gobuild-android`
-1. `yarn rn-start android`
-1. `yarn rn-build-android` (or `gradle installDebug` inside android),
-1. `yarn rn-push-android` (To install the apk on the device. NOTE: `gradle installDebug` does this automatically)
-
-and have an emulator or android device connected. (i.e. `adb devices` should list _exactly_ one device)
-
-Then you can run
-
-```sh
-yarn rn-push-android
-```
+1. `yarn react-native run-android`
 
-to push the debug APK to your emulator or device, and it should
-connect to the react-native packager instance on your machine. Happy
-developing!
+Happy developing!
 
 ### Troubleshooting
 
diff --git a/shared/package.json b/shared/package.json
index f141246e086d..e241bd058620 100644
--- a/shared/package.json
+++ b/shared/package.json
@@ -38,10 +38,10 @@
     "rn-start": "./react-native/packageAndBuild.sh",
     "rn-gobuild-ios": "./react-native/gobuild.sh ios",
     "rn-gobuild-android": "./react-native/gobuild.sh android",
-    "rn-build-android": "rm -rf ./android/app/build && ./react-native/buildAndroid.sh debug",
-    "rn-push-android": "./react-native/pushAndroid.sh debug",
-    "rn-build-storybook-android": "rm -rf ./android/app/build && ./react-native/buildAndroid.sh storybook",
-    "rn-push-storybook-android": "./react-native/pushAndroid.sh storybook",
+    "rn-build-android": "echo deprecated, see docs!! && rm -rf ./android/app/build && ./react-native/buildAndroid.sh debug",
+    "rn-push-android": "echo deprecated, see docs!! && ./react-native/pushAndroid.sh debug",
+    "rn-build-storybook-android": "echo deprecated, see docs!! && rm -rf ./android/app/build && ./react-native/buildAndroid.sh storybook",
+    "rn-push-storybook-android": "echo deprecated, see docs!! && ./react-native/pushAndroid.sh storybook",
     "rn-packager-wipe-cache": "watchman watch-del-all && rm -rf node_modules && yarn && node ./react-native/wipe-cache.js",
     "rn-test-ios": "xcodebuild test -project ./ios/Keybase.xcodeproj -scheme 'Keybase For Test' -destination 'platform=iOS Simulator,name=iPhone 6s,OS=9.3'",
     "rn-jsbuild-ios": "mkdir -p ios/dist && react-native bundle --platform ios --dev false --entry-file index.ios.js --bundle-output ios/dist/main.jsbundle --sourcemap-output ios/dist/main.jsbundle.sourcemap",