From 5d40429989f40f483e109ae7493d4ab3dc8a70b7 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Sun, 9 Nov 2025 07:15:44 +0000
Subject: [PATCH 1/2] Update docs to reflect v11 as default in Mapbox 10.2

- Changed section title from "Using V11" to "Customizing Mapbox Version"
- Updated documentation to reflect that @rnmapbox/maps 10.2 now defaults to v11
- Added deprecation notice for Mapbox Maps SDK v10
- Restructured instructions to show v10 as the non-default, deprecated option
- Updated "Advanced" section to clarify how to use specific v11 versions
---
 docs/install.md | 26 +++++++++++++-------------
 1 file changed, 13 insertions(+), 13 deletions(-)

diff --git a/docs/install.md b/docs/install.md
index c30f6ad..8a07f84 100644
--- a/docs/install.md
+++ b/docs/install.md
@@ -152,9 +152,15 @@ expo prebuild --clean
 </TabItem>
 </Tabs>
 
-## Using V11
+## Customizing Mapbox Version
 
-@rnmapbox 10.1 supports both `10.16.*` and `11.0.*` versions, but defaults to `10.16.*`. To use `11.0.*` please configure according to your platform:
+@rnmapbox/maps 10.2 defaults to Mapbox Maps SDK `11.0.*`.
+
+> **Note:** Mapbox Maps SDK v10 is now deprecated. We recommend using v11 for new projects and upgrading existing projects to v11.
+
+### Using V10 (Deprecated)
+
+If you need to use the deprecated `10.16.*` version, you can configure it according to your platform:
 
 <Tabs groupId="v11-insructions" queryString defaultValue="expo" values={[
     {label:'iOS', value:'ios'},
@@ -166,13 +172,7 @@ expo prebuild --clean
 Add the following to your `ios/Podfile`
 
 ```ruby
-$RNMapboxMapsVersion = '= 11.0.0'
-```
-
-Since Mapbox Maps 11 requires ios 12.4 or later, you might need to update deployment target line in your `ios/Podfile`:
-
-```ruby
-platform :ios, '12.4' # change to minimum 12.4
+$RNMapboxMapsVersion = '~> 10.16.0'
 ```
 
 </TabItem>
@@ -184,7 +184,7 @@ Set `RNMapboxMapsVersion` in `android/build.gradle` > `buildscript` > `ext` sect
 buildscript {
     ext {
 // highlight-start
-        RNMapboxMapsVersion = '11.0.0'
+        RNMapboxMapsVersion = '10.16.4'
 // highlight-end
     }
 }
@@ -204,7 +204,7 @@ Add `RNMapboxMapsVersion` to the @rnmapbox/maps [config plugin](https://docs.exp
         {
           ...
 // highlight-start
-          "RNMapboxMapsVersion": "11.0.0"
+          "RNMapboxMapsVersion": "10.16.4"
 // highlight-end
         }
       ]
@@ -219,9 +219,9 @@ Add `RNMapboxMapsVersion` to the @rnmapbox/maps [config plugin](https://docs.exp
 
 ## Advanced - using non default version
 
-It's possible to overwrite the native SDK version with `RNMapboxMapsVersion`. But you have to revise it when upgrading `@rnmapbox/maps` as future `@rnmapbox/maps` releases might not support he version you set today.
+It's possible to overwrite the native SDK version with `RNMapboxMapsVersion`. However, you should revise this when upgrading `@rnmapbox/maps` as future releases might not support the version you set.
 
-Follow the instructions above [on using v11](#using-v11), just use 10.* version you'd like.
+To use a specific v11 version, follow the instructions above [for customizing the Mapbox version](#customizing-mapbox-version), specifying your desired `11.*` version (e.g., `11.0.0`, `11.1.0`, etc.).
 
 ## Configure permissions for location access
 

From 9746e4ece0a1d8795152eb90c3053e6a74be0f46 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Sun, 9 Nov 2025 08:57:31 +0000
Subject: [PATCH 2/2] Fix Tabs groupId to v10-instructions for deprecated v10
 section

---
 docs/install.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/install.md b/docs/install.md
index 8a07f84..49348b2 100644
--- a/docs/install.md
+++ b/docs/install.md
@@ -162,7 +162,7 @@ expo prebuild --clean
 
 If you need to use the deprecated `10.16.*` version, you can configure it according to your platform:
 
-<Tabs groupId="v11-insructions" queryString defaultValue="expo" values={[
+<Tabs groupId="v10-instructions" queryString defaultValue="expo" values={[
     {label:'iOS', value:'ios'},
     {label:'Android', value:'android'},
     {label:'Expo', value: 'expo'}