diff --git a/README.md b/README.md
index 697a008..5a9e1f1 100644
--- a/README.md
+++ b/README.md
@@ -35,3 +35,17 @@ xcode {
 
 The 'projectPath' points at the Xcode project folder. 'target' is the target inside the Xcode project. There's also the optional 
 parameter 'group', which by default is set to 'Kotlin'. That is the group folder that files are copied into.
+
+Install the `xcodeproj` gem
+
+```bash
+sudo gem install xcodeproj
+```
+
+To update your Xcode project, run
+
+```bash
+./gradlew :shared:xcodeSync
+```
+
+(assuming your shared module is called `shared`)