diff --git a/README.md b/README.md
index edddd1a..9fcde39 100644
--- a/README.md
+++ b/README.md
@@ -44,6 +44,9 @@ to
 default = ["metal"]
 ```
 
+If using OSX and Metal you will require full XCode installed from the Appstore in order to compile metal shaders.
+After install you may be required to run this command `sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer` [reference gfx-rs issue](https://github.com/gfx-rs/gfx/issues/2472)
+
 #### For Linux Users
 
 You might need to install some dependencies. Please refer to [this section](https://github.com/amethyst/amethyst#dependencies) of the README for more details.