Skip to content

Update docs to reflect v11 as default in Mapbox 10.2 #12

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
mfazekas merged 2 commits into from
Nov 9, 2025
Merged

Update docs to reflect v11 as default in Mapbox 10.2 #12

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
5d40429
Update docs to reflect v11 as default in Mapbox 10.2
claude Nov 9, 2025
9746e4e
Fix Tabs groupId to v10-instructions for deprecated v10 section
claude Nov 9, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 14 additions & 14 deletions docs/install.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -152,11 +152,17 @@ 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.*`.

<Tabs groupId="v11-insructions" queryString defaultValue="expo" values={[
> **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="v10-instructions" queryString defaultValue="expo" values={[
{label:'iOS', value:'ios'},
{label:'Android', value:'android'},
{label:'Expo', value: 'expo'}
Expand All @@ -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>
Expand All @@ -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
}
}
Expand All @@ -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
}
]
Expand All @@ -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

Expand Down