diff --git a/docs/getting-started/mobile/ios/index.md b/docs/getting-started/mobile/ios/index.md
index 7028b5307..af1e1dcb6 100644
--- a/docs/getting-started/mobile/ios/index.md
+++ b/docs/getting-started/mobile/ios/index.md
@@ -6,8 +6,13 @@ sidebar_position: 1
 
 ## Requirements
 
-1. [Xcode](https://developer.apple.com/xcode/) (version 16.3)
-2. An iPhone 16 Pro simulator (iOS 18.1) set up
+1. [Xcode](https://developer.apple.com/xcode/) (using
+   [this](https://github.com/bitwarden/ios/blob/main/.xcode-version) version)
+2. iOS & watchOS simulator runtimes installed
+3. An iPhone simulator set up (check
+   [model](https://github.com/bitwarden/ios/blob/main/.test-simulator-device-name) &
+   [version](https://github.com/bitwarden/ios/blob/main/.test-simulator-ios-version) to make/run
+   snapshots)
 
 ## Setup
 
@@ -56,6 +61,15 @@ sidebar_position: 1
    $ cp Scripts/post-checkout .git/hooks/
    ```
 
+   Also, if the Xcode version installed mismatches the expected one you will receive a warning when
+   the script finishes like this one which can help troubleshooting.
+
+   ```
+   🟡 Xcode version mismatch!
+   Required version: 26.0.1
+   Current version: 16.4
+   ```
+
 4. Install [fastlane](https://docs.fastlane.tools/) for automated package deployments:
 
    > **Note** We manage non-system Ruby installations with `rbenv` as homebrew tends to break the
@@ -107,7 +121,7 @@ sidebar_position: 1
 
 ### Run the app
 
-1. Open the project in Xcode 16.3+.
+1. Open the project in Xcode.
 2. Run the app in the Simulator with the `Bitwarden` target for the Password Manager app or
    `Authenticator` for the Authenticator app.