diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 84ae9df..c5e9eb9 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -29,6 +29,24 @@ npm install
 cd -
 ```
 
+### Troubleshooting:
+- `libv8` or `therubyracer` MacOS Catalina/Big Sur install issues:
+  ```
+  An error occurred while installing libv8 (3.16.14.19), and Bundler cannot continue.
+  Make sure that `gem install libv8 -v '3.16.14.19' --source 'https://rubygems.org/'` succeeds before bundling.
+
+  An error occurred while installing therubyracer (0.12.3), and Bundler cannot continue.
+  Make sure that `gem install therubyracer -v '0.12.3' --source 'https://rubygems.org/'` succeeds before bundling.
+  ```
+
+  Try, [reference](https://stackoverflow.com/a/62413041/7477016):
+  ```
+  brew install v8@3.15
+  bundle config build.libv8 --with-system-v8
+  bundle config build.therubyracer --with-v8-dir=$(brew --prefix v8@3.15)
+  bundle
+  ```
+
 ## Test
 Initialize the rswag-ui repo with assets.
 ```