fix: auto-configure local Maven repo for shared-storage dependency

[roidayan1]

Summary

• Auto-configure the local Maven repository for shared-storage in the library's own build.gradle
• Remove the manual Android setup step from README, migration guide, and example project

Problem

The org.asyncstorage.shared_storage:storage-android:1.0.0 artifact is bundled in android/local_repo/ but is not published to Maven Central or Google's Maven repository. This means every consumer must manually add the local Maven URL to their root android/build.gradle:

allprojects {
    repositories {
        maven {
            url = uri(project(":react-native-async-storage_async-storage").file("local_repo"))
        }
    }
}

This is easy to miss during installation and causes confusing Gradle build failures (Could not find org.asyncstorage.shared_storage:storage-android:1.0.0).

Fix

Add the local Maven repository configuration directly to the library's packages/async-storage/android/build.gradle:

1. Module-level: maven { url("${project.projectDir}/local_repo") } — resolves the dependency for the module itself
2. rootProject.allprojects: maven { url("${rootDir}/../node_modules/...") } — ensures transitive resolution across the entire Android build

This makes it work out of the box — no manual setup required.

Changes

• packages/async-storage/android/build.gradle — add local Maven repo configuration
• README.md — remove manual Android setup section
• docs/migration-to-3.md — remove manual Android setup instructions
• examples/react-native/android/build.gradle — remove manual repo config (now inherited)

Patch (for patch-package users)

Until this is released, you can use this patch with patch-package:

@react-native-async-storage+async-storage+3.0.1.patch

diff --git a/node_modules/@react-native-async-storage/async-storage/android/build.gradle b/node_modules/@react-native-async-storage/async-storage/android/build.gradle
index 4f80202..19613fa 100644
--- a/node_modules/@react-native-async-storage/async-storage/android/build.gradle
+++ b/node_modules/@react-native-async-storage/async-storage/android/build.gradle
@@ -78,10 +78,21 @@ android {
 }

 repositories {
+    maven {
+        url("${project.projectDir}/local_repo")
+    }
     mavenCentral()
     google()
 }

+rootProject.allprojects {
+    repositories {
+        maven {
+            url("${rootDir}/../node_modules/@react-native-async-storage/async-storage/android/local_repo")
+        }
+    }
+}
+
 dependencies {
     implementation "com.facebook.react:react-android"
     api "org.asyncstorage.shared_storage:storage-android:1.0.0"

[changeset-bot]

⚠️ No Changeset found

Latest commit: a7cdd18

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[roidayan1]

@krizzu @tido64 please review

[krizzu]

The reason why I did not do it this way, is because async-storage ends up being a submodule in your project. That means, root project is already evaluated, before async-storage is. So changing root at that time, will only modify it for upcoming modules, not yet evaluated.