From eed2e083133735d0db7ac2dfaa3c3e2343f750f6 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Sun, 21 Dec 2025 08:27:45 +0000
Subject: [PATCH] docs: remove deprecated download token documentation

Download token (RNMAPBOX_MAPS_DOWNLOAD_TOKEN) is no longer required by
Mapbox for accessing their SDKs. This cleans up user-facing documentation
to remove instructions about setting this token, reducing confusion
between download tokens and access tokens.

Fixes #4121
---
 ios/install.md               |  3 ---
 plugin/build/withMapbox.d.ts |  3 +++
 plugin/install.md            | 19 -------------------
 plugin/src/withMapbox.ts     |  3 +++
 rnmapbox-maps.podspec        |  2 +-
 5 files changed, 7 insertions(+), 23 deletions(-)

diff --git a/ios/install.md b/ios/install.md
index b950b9a6c2..19114ef7f1 100644
--- a/ios/install.md
+++ b/ios/install.md
@@ -25,9 +25,6 @@ Add the following to your `ios/Podfile`:
 
 <br>
 
-You will need to authorize your download of the Maps SDK with a secret access token with the `DOWNLOADS:READ` scope. This [guide](https://docs.mapbox.com/ios/maps/guides/install/#configure-credentials) explains how to configure the secret token under section `Configure your secret token`.
-
-
 Run `pod install` to download the proper mapbox dependency.
 
 ```sh
diff --git a/plugin/build/withMapbox.d.ts b/plugin/build/withMapbox.d.ts
index 19c21b2899..95621dd35a 100644
--- a/plugin/build/withMapbox.d.ts
+++ b/plugin/build/withMapbox.d.ts
@@ -6,6 +6,9 @@ export type MapboxPlugProps = {
      */
     RNMapboxMapsImpl?: 'mapbox';
     RNMapboxMapsVersion?: string;
+    /**
+     * @deprecated Download token is no longer required by Mapbox. Do not set this.
+     */
     RNMapboxMapsDownloadToken?: string;
     RNMapboxMapsUseV11?: boolean;
 };
diff --git a/plugin/install.md b/plugin/install.md
index 0b21373a50..77764ca065 100644
--- a/plugin/install.md
+++ b/plugin/install.md
@@ -28,15 +28,6 @@ After installing this package, add the [config plugin](https://docs.expo.io/guid
 }
 ```
 
-You'll need to provide a download token. Set the `RNMAPBOX_MAPS_DOWNLOAD_TOKEN` environment variable to your download token (requires the `DOWNLOADS:READ` scope):
-
-```bash
-export RNMAPBOX_MAPS_DOWNLOAD_TOKEN="sk.ey...qg"
-npx expo prebuild
-```
-
-For more information about obtaining a download token, refer to the [iOS guide](https://docs.mapbox.com/ios/maps/guides/install/#configure-credentials), which explains how to configure this token under the section `Configure your secret token`.
-
 If you want to show the user's current location on the map with the [UserLocation](../docs/UserLocation.md) component, you can use the [expo-location](https://docs.expo.dev/versions/latest/sdk/location/) plugin to configure the required `NSLocationWhenInUseUsageDescription` property. Install the plugin with `npx expo install expo-location` and add its config plugin to the plugins array of your `app.{json,config.js,config.ts}`:
 
 ```json
@@ -92,16 +83,6 @@ To use V11 just set the version to a 11 version, see [the ios guide](/ios/instal
 }
 ```
 
-### Download Token Configuration
-
-For Expo projects, we recommend using the `RNMAPBOX_MAPS_DOWNLOAD_TOKEN` environment variable:
-
-```bash
-# Set the environment variable before building
-export RNMAPBOX_MAPS_DOWNLOAD_TOKEN="sk.ey...qg"
-npx expo prebuild
-```
-
 ## Manual Setup
 
 For bare workflow projects, you can follow the manual setup guides:
diff --git a/plugin/src/withMapbox.ts b/plugin/src/withMapbox.ts
index 93650143f6..5da0312283 100644
--- a/plugin/src/withMapbox.ts
+++ b/plugin/src/withMapbox.ts
@@ -37,6 +37,9 @@ export type MapboxPlugProps = {
 
   RNMapboxMapsVersion?: string;
 
+  /**
+   * @deprecated Download token is no longer required by Mapbox. Do not set this.
+   */
   RNMapboxMapsDownloadToken?: string;
 
   RNMapboxMapsUseV11?: boolean;
diff --git a/rnmapbox-maps.podspec b/rnmapbox-maps.podspec
index 38578ac4b1..7e9005e9d4 100644
--- a/rnmapbox-maps.podspec
+++ b/rnmapbox-maps.podspec
@@ -12,7 +12,7 @@
 #           product_name: "Mapbox"
 #         }
 #         ```
-#  $RNMapboxMapsDownloadToken - *expo only* download token
+#  $RNMapboxMapsDownloadToken - *deprecated* download token is no longer required
 #  $RNMapboxMapsCustomPods - use a custom pod for mapbox libs
 
 require 'json'