diff --git a/content/setup/macos.md b/content/setup/macos.md
index 72e07a37..d935a4e8 100644
--- a/content/setup/macos.md
+++ b/content/setup/macos.md
@@ -278,6 +278,22 @@ If you see **No issues were detected** then you have successfully set up your sy
 
 ::: warning Troubleshooting
 
-If any of the above failed, we recommend asking in [our Community Discord](https://nativescript.org/discord) for assistance.
+Did you see this warning?
+
+```
+✖ WARNING: Xcode is not installed or is not configured properly. 
+ You will not be able to build your projects for iOS or run them in the iOS Simulator.
+To be able to build for iOS and run apps in the native emulator, verify that you have installed Xcode. 
+
+Your environment is not configured properly and you will not be able to execute local builds.
+Verify that your environment is configured according to the system requirements described at
+https://docs.nativescript.org/setup/macos#setting-up-macos-for-ios.
+```
+
+If so, you can likely just run: `sudo xcode-select --reset`
+
+Now try `ns doctor ios` again.
+
+If any others failed, we recommend asking in [our Community Discord](https://nativescript.org/discord) for assistance.
 
 :::