From 29e6d5e09989f5c322d4114876753ea88c893ed2 Mon Sep 17 00:00:00 2001
From: Matthew Raymer <matthew.raymer@anomalistdesign.com>
Date: Mon, 21 Jul 2025 07:16:11 +0000
Subject: [PATCH] Improve iOS build directory documentation and clarity

- Add clarifying comment in ios/.gitignore for App/App/public directory
- Document that public directory contains Capacitor sync output from dist/
- Add comment in build-ios.sh clarifying build directory is temporary output
- Reinforces best practice of keeping platform files in ios/ folder
---
 ios/.gitignore       | 1 +
 scripts/build-ios.sh | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/ios/.gitignore b/ios/.gitignore
index 77aed71c..db3f1b6f 100644
--- a/ios/.gitignore
+++ b/ios/.gitignore
@@ -1,6 +1,7 @@
 App/build
 App/Pods
 App/output
+# Capacitor sync output - contains web assets copied from dist/
 App/App/public
 DerivedData
 xcuserdata
diff --git a/scripts/build-ios.sh b/scripts/build-ios.sh
index e014cd3e..b4ee52e3 100755
--- a/scripts/build-ios.sh
+++ b/scripts/build-ios.sh
@@ -174,7 +174,7 @@ check_ios_resources() {
 clean_ios_build() {
     log_info "Cleaning iOS build artifacts..."
     
-    # Clean Xcode build
+    # Clean Xcode build (temporary output directory)
     if [ -d "ios/App/build" ]; then
         rm -rf ios/App/build/
         log_debug "Cleaned ios/App/build/"