From 42040e4fc977ca697091d49aec6c1372c22e5ef6 Mon Sep 17 00:00:00 2001
From: Mohamed Javid <19339952+smohamedjavid@users.noreply.github.com>
Date: Fri, 16 Jun 2023 02:07:11 +0800
Subject: [PATCH] Update default iOS Simulator (#16289)

Signed-off-by: Mohamed Javid <19339952+smohamedjavid@users.noreply.github.com>
---
 Makefile              |  2 +-
 doc/starting-guide.md | 23 +++++++++++++++++++++--
 2 files changed, 22 insertions(+), 3 deletions(-)

diff --git a/Makefile b/Makefile
index 3ce599af4f..e4b8be9a93 100644
--- a/Makefile
+++ b/Makefile
@@ -268,7 +268,7 @@ run-android: export TARGET := android
 run-android: ##@run Build Android APK and start it on the device
 	npx react-native run-android --appIdSuffix debug
 
-SIMULATOR=iPhone 13
+SIMULATOR=iPhone 11 Pro
 run-ios: export TARGET := ios
 run-ios: ##@run Build iOS app and start it in a simulator/device
 ifneq ("$(SIMULATOR)", "")
diff --git a/doc/starting-guide.md b/doc/starting-guide.md
index 90f54ddd93..3e13101cdf 100644
--- a/doc/starting-guide.md
+++ b/doc/starting-guide.md
@@ -28,11 +28,30 @@ You need to have an emulator like [AVD](https://developer.android.com/studio/run
 
 ### iOS
 
-You can specify the simulator type by adding the `SIMULATOR` flag:
+#### Running on a simulator
+
+We highly recommend using the `iPhone 11 Pro` simulator as its screen dimensions match with our design.
+
+If you have Xcode `v12.x` (and above) installed in your system, you need to follow the below steps to add `iPhone 11 Pro` simulator:
+
+1. Open Xcode
+2. Menu `>` Window `>` Devices and Simulators
+3. Tap `+` button on bottom left
+4. Select **Device Type** as `iPhone 11 Pro`
+5. Leave the **Simulator Name** empty and tap on **Create**
+
+##### NOTE ⚠️
+
+Running `make run-ios` will target `iPhone 11 Pro` by default.
+
+If you need to run on any other simulator, you can specify the simulator type by adding the `SIMULATOR` flag:
 ```sh
 make run-ios SIMULATOR="iPhone 11 Pro"
 ```
-Some manual steps are necesary for [developing on a physical iOS Device](#physical-ios-device).
+
+#### Running on a physical device
+
+Some manual steps are necessary for [developing on a physical iOS Device](#physical-ios-device).
 
 # Build release