From b37293bcc01265d5904a5e9ffe8d6017ec26fc75 Mon Sep 17 00:00:00 2001
From: Mitchell Hashimoto <mitchell.hashimoto@gmail.com>
Date: Tue, 9 Jan 2024 08:58:56 -0800
Subject: [PATCH] Update README.md

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

diff --git a/README.md b/README.md
index 29c3cc25c..348df9a56 100644
--- a/README.md
+++ b/README.md
@@ -498,6 +498,12 @@ $ zig build -Doptimize=ReleaseFast
 $ cd macos && xcodebuild
 ```
 
+> [!NOTE] 
+> If you're using the Nix environment on macOS, `xcodebuild` will
+> fail due to the linker environment variables Nix sets. You must
+> run the `xcodebuild` command specifically outside of the Nix
+> environment.
+
 This will output the app to `macos/build/ReleaseLocal/Ghostty.app`.
 This app will be not be signed or notarized.
 [Official continuous builds are available](https://github.com/mitchellh/ghostty/releases/tag/tip)