From 9867a5d7c9b191413e1b3c997854fc4c0eb69cef Mon Sep 17 00:00:00 2001
From: Matt Parker <61717342+MattParkerDev@users.noreply.github.com>
Date: Sun, 21 Dec 2025 12:47:55 +1000
Subject: [PATCH] Update README.md

---
 README.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/README.md b/README.md
index dfe883f..a52a14b 100644
--- a/README.md
+++ b/README.md
@@ -12,6 +12,21 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for instructions for building and running
 ### WIP
 SharpIDE is a WIP, and contributions are always welcome! If you encounter an error, please raise an issue! 😊
 
+### FAQs
+
+<details><summary>SharpIDE won't open on MacOS Tahoe</summary>
+Tahoe further restricted users' ability to run unsigned software. Follow these steps to get it running:
+
+1. download a fresh zip of the latest release
+2. extract
+3. move SharpIDE.app to `Applications`
+4. open terminal
+5. run `xattr -d -r com.apple.quarantine /Applications/SharpIDE.app`
+6. run `sudo codesign --force --deep --sign - /Applications/SharpIDE.app`
+
+if codesign is not installed, install it with `xcode-select --install`
+</details>
+
 <img width="1638" height="935" alt="image" src="https://github.com/user-attachments/assets/bce91555-a1f2-43ab-a525-8353b4c7cff2" />
 
 ## Completions