docs: add Xcode 26.2 and EAS Build requirements (#371)

- Add Xcode 26.2 as strongly recommended prerequisite
- Add EAS Build configuration section with iOS build image requirements
- Add troubleshooting section for Xcode and EAS build issues

Author: mickeypause

README.md

@@ -31,6 +31,7 @@ The true native bottom sheet experience for your React Native Apps. 💩
 
 - React Native >= 0.76 (Expo SDK 52+)
 - New Architecture enabled (default in RN 0.76+)
+- Xcode 26.2 (strongly recommended for better library functionality)
 
 ### Expo
 
@@ -45,6 +46,27 @@ yarn add @lodev09/react-native-true-sheet
 cd ios && pod install
 ```
 
+### EAS Build (iOS)
+
+When using [EAS Build](https://docs.expo.dev/build/introduction/) to build your iOS app, you must configure your `eas.json` to use a build image that includes Xcode 26.2. Use `"image": "latest"` or choose from the [available build images](https://docs.expo.dev/build-reference/infrastructure/#ios-server-images):
+
+```json
+{
+  "build": {
+    "production": {
+      "ios": {
+        "image": "latest"
+      }
+    },
+    "development": {
+      "ios": {
+        "image": "latest"
+      }
+    }
+  }
+}
+```
+
 ## Documentation
 
 - [Example](example)

docs/docs/install.mdx

@@ -10,6 +10,7 @@ keywords: [bottom sheet installation, bottom sheet yarn, bottom sheet npm, ios b
 
 - React Native >= 0.76 (Expo SDK 52+)
 - New Architecture enabled (default in RN 0.76+)
+- Xcode 26.2 (strongly recommended for better library functionality)
 
 :::info
 This package is not compatible with [Expo Go](https://docs.expo.dev/get-started/expo-go/). Use this with [Expo CNG](https://docs.expo.dev/workflow/continuous-native-generation/) instead.
@@ -32,3 +33,24 @@ Then install the native dependencies:
 ```sh
 cd ios && pod install
 ```
+
+## EAS Build (iOS)
+
+When using [EAS Build](https://docs.expo.dev/build/introduction/) to build your iOS app, you must configure your `eas.json` to use a build image that includes Xcode 26.2. Use `"image": "latest"` or choose from the [available build images](https://docs.expo.dev/build-reference/infrastructure/#ios-server-images):
+
+```json
+{
+  "build": {
+    "production": {
+      "ios": {
+        "image": "latest"
+      }
+    },
+    "development": {
+      "ios": {
+        "image": "latest"
+      }
+    }
+  }
+}
+```

docs/docs/troubleshooting.mdx

@@ -94,3 +94,40 @@ A fix has been submitted to React Native. See [PR #55005](https://github.com/fac
 ## Weird layout render
 
 The sheet does not have control over how React Native renders components and may lead to rendering issues. To resolve this, try to minimize the use of `flex=1` in your content styles. Instead, use fixed `height` or employ `flexGrow`, `flexBasis`, etc., to manage your layout requirements.
+
+## Build Failures with Xcode or EAS
+
+If you encounter build failures when building your iOS app, it may be due to an incorrect Xcode version or EAS build configuration.
+
+### Xcode Version
+
+The package works better with **Xcode 26.2**. If you're building locally, check your Xcode version:
+
+```sh
+xcodebuild -version
+```
+
+If you're experiencing issues, we recommend updating to Xcode 26.2.
+
+### EAS Build Configuration
+
+When using [EAS Build](https://docs.expo.dev/build/introduction/), you must configure your `eas.json` to use a build image that includes Xcode 26.2 to build your app. Use `"image": "latest"` or choose from the [available build images](https://docs.expo.dev/build-reference/infrastructure/#ios-server-images):
+
+```json
+{
+  "build": {
+    "production": {
+      "ios": {
+        "image": "latest"
+      }
+    },
+    "development": {
+      "ios": {
+        "image": "latest"
+      }
+    }
+  }
+}
+```
+
+Without this configuration, EAS may use an older build image that doesn't include Xcode 26.2, causing build failures.