docs: update READMEs + example configs to useLocalNatives

Sweep across every doc + config file that referenced the old toggle
names so the entire repo is internally consistent with the canonical
`useLocalNatives` property name landed in the build files.

Files touched:
- AGENTS.md, build.gradle.kts, jitpack.yml
- docs/building.md, docs/sdks/kotlin-sdk.md
- sdk/runanywhere-{swift,kotlin,flutter,react-native}/README.md
- sdk/runanywhere-kotlin/docs/KOTLIN_MAVEN_CENTRAL_PUBLISHING.md
- sdk/runanywhere-kotlin/modules/runanywhere-core-{llamacpp,onnx}/README.md
- examples/android/RunAnywhereAI/README.md
- examples/react-native/RunAnywhereAI/android/gradle.properties.example

No code changes. `runanywhere.testLocal` (the legacy alias) still works
as documented in the build files — these docs just surface the canonical
name as primary.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: sanchitmonga22

AGENTS.md

@@ -8,7 +8,7 @@ This is a cross-platform SDK monorepo. On a Linux cloud VM, the buildable servic
 
 | Component | Build | Test | Lint | Notes |
 |-----------|-------|------|------|-------|
-| Kotlin SDK (Android target) | `./gradlew :runanywhere-kotlin:compileDebugKotlinAndroid -Prunanywhere.testLocal=false` | Android unit tests require device/emulator | `./gradlew :runanywhere-kotlin:runKtlintCheckOverCommonMainSourceSet` | JVM target has a known issue: `RAGBridge.kt` in `jvmAndroidMain` imports `@Keep` from `androidx.annotation` which is unavailable for JVM compilation |
+| Kotlin SDK (Android target) | `./gradlew :runanywhere-kotlin:compileDebugKotlinAndroid -Prunanywhere.useLocalNatives=false` | Android unit tests require device/emulator | `./gradlew :runanywhere-kotlin:runKtlintCheckOverCommonMainSourceSet` | JVM target has a known issue: `RAGBridge.kt` in `jvmAndroidMain` imports `@Keep` from `androidx.annotation` which is unavailable for JVM compilation |
 | Web SDK (TypeScript) | `npm run build -w packages/core` (from `sdk/runanywhere-web/`) | N/A | `npm run typecheck -w packages/core` | `llamacpp` package has a pre-existing duplicate index signature TS error |
 | Web Example App | `npm run dev` (from `examples/web/RunAnywhereAI/`) | Manual browser testing at `localhost:5173` | N/A | Full Vite app, works in demo mode without WASM |
 | C++ Commons (core) | `cmake -B build ... && cmake --build build` (from `sdk/runanywhere-commons/`) | `./build/tests/test_core --run-all` (13 tests, no models needed) | N/A | Must use `gcc`/`g++` via `CC=gcc CXX=g++` (clang lacks C++ stdlib headers). Pass `-DRAC_BUILD_PLATFORM=OFF` on Linux |
@@ -21,7 +21,7 @@ This is a cross-platform SDK monorepo. On a Linux cloud VM, the buildable servic
 
 - **Android SDK**: Installed at `/opt/android-sdk`. `ANDROID_HOME` and `JAVA_HOME` are set in `~/.bashrc`.
 - **JDK 17**: Required by Gradle JVM toolchain. Both JDK 17 and JDK 21 are installed.
-- **`testLocal` flag**: Set to `true` in `gradle.properties`. Pass `-Prunanywhere.testLocal=false` to Gradle to avoid needing Android NDK (downloads pre-built JNI libs from GitHub releases instead of building locally).
+- **`testLocal` flag**: Set to `true` in `gradle.properties`. Pass `-Prunanywhere.useLocalNatives=false` to Gradle to avoid needing Android NDK (downloads pre-built JNI libs from GitHub releases instead of building locally).
 - **C++ compiler**: Default clang on this VM lacks `libc++` headers. Use `gcc`/`g++` via `-DCMAKE_C_COMPILER=gcc -DCMAKE_CXX_COMPILER=g++`.
 - **`local.properties`**: Auto-created at root, `sdk/runanywhere-kotlin/`, and `examples/android/RunAnywhereAI/` with `sdk.dir=/opt/android-sdk`.
 - **pre-commit hooks**: Installed via `pre-commit install`. Requires `git config --unset-all core.hooksPath` first if `core.hooksPath` is set.

build.gradle.kts

@@ -115,7 +115,7 @@ tasks.register("setup") {
 
         // Check build mode and run native setup if needed
         val testLocal = projectDir.resolve("gradle.properties").let { f ->
-            f.exists() && f.readText().contains("runanywhere.testLocal=true")
+            f.exists() && f.readText().contains("runanywhere.useLocalNatives=true")
         }
         println("Build mode: testLocal=$testLocal")
 

docs/building.md

@@ -83,15 +83,15 @@ Native libraries can be sourced in two ways, controlled by `gradle.properties`:
 Downloads pre-built `.so` files from GitHub releases. No NDK required.
 
 ```properties
-runanywhere.testLocal=false
+runanywhere.useLocalNatives=false
 ```
 
 ### Local mode (for C++ development)
 
 Builds native libraries from `runanywhere-commons` source. Requires NDK.
 
 ```properties
-runanywhere.testLocal=true
+runanywhere.useLocalNatives=true
 ```
 
 First-time local setup:

docs/sdks/kotlin-sdk.md

@@ -519,10 +519,10 @@ Controlled by `gradle.properties`:
 
 ```properties
 # Local development (build C++ from source)
-runanywhere.testLocal=true
+runanywhere.useLocalNatives=true
 
 # CI/Release (download pre-built from GitHub releases)
-runanywhere.testLocal=false
+runanywhere.useLocalNatives=false
 runanywhere.nativeLibVersion=0.1.4
 ```
 

examples/android/RunAnywhereAI/README.md

@@ -61,7 +61,7 @@ The `build-kotlin.sh --setup` script:
 1. Downloads dependencies (Sherpa-ONNX, ~500MB)
 2. Builds the native C++ libraries from `runanywhere-commons`
 3. Copies JNI `.so` files to `sdk/runanywhere-kotlin/src/androidMain/jniLibs/`
-4. Sets `runanywhere.testLocal=true` in `gradle.properties`
+4. Sets `runanywhere.useLocalNatives=true` in `gradle.properties`
 
 ### After Modifying the SDK
 

examples/react-native/RunAnywhereAI/android/gradle.properties.example

@@ -10,7 +10,7 @@ android.enableJetifier=false
 # RunAnywhere SDK - Local Development
 # Set to true to use locally built native libraries
 # Set to false to download from GitHub releases
-runanywhere.testLocal=true
+runanywhere.useLocalNatives=true
 
 # Gradle JVM Settings
 # Increase memory for React Native builds

jitpack.yml

@@ -28,4 +28,4 @@ before_install:
 install:
   # Chain all commands so environment variables persist
   # Use publishToMavenLocal (not publishAllPublicationsToMavenLocal which doesn't exist)
-  - export ANDROID_HOME=$HOME/android-sdk && export ANDROID_SDK_ROOT=$HOME/android-sdk && export PATH=$PATH:$ANDROID_HOME/cmdline-tools/latest/bin:$ANDROID_HOME/platform-tools && cd sdk/runanywhere-kotlin && ./gradlew downloadJniLibs -Prunanywhere.testLocal=false --no-daemon && ./gradlew assembleRelease publishToMavenLocal -Prunanywhere.testLocal=false --no-daemon --info 2>&1 | tail -300
+  - export ANDROID_HOME=$HOME/android-sdk && export ANDROID_SDK_ROOT=$HOME/android-sdk && export PATH=$PATH:$ANDROID_HOME/cmdline-tools/latest/bin:$ANDROID_HOME/platform-tools && cd sdk/runanywhere-kotlin && ./gradlew downloadJniLibs -Prunanywhere.useLocalNatives=false --no-daemon && ./gradlew assembleRelease publishToMavenLocal -Prunanywhere.useLocalNatives=false --no-daemon --info 2>&1 | tail -300

sdk/runanywhere-kotlin/README.md

@@ -450,16 +450,16 @@ cd runanywhere-sdks/sdk/runanywhere-kotlin
 1. Downloads dependencies (Sherpa-ONNX, ~500MB)
 2. Builds `runanywhere-commons` for Android (arm64-v8a by default)
 3. Copies JNI libraries (`.so` files) to module `jniLibs/` directories
-4. Sets `runanywhere.testLocal=true` in `gradle.properties`
+4. Sets `runanywhere.useLocalNatives=true` in `gradle.properties`
 
 ### Understanding testLocal
 
-The SDK has two modes controlled by `runanywhere.testLocal` in `gradle.properties`:
+The SDK has two modes controlled by `runanywhere.useLocalNatives` in `gradle.properties`:
 
 | Mode | Setting | Description |
 |------|---------|-------------|
-| **Local** | `runanywhere.testLocal=true` | Uses JNI libs from `src/androidMain/jniLibs/` (for development) |
-| **Remote** | `runanywhere.testLocal=false` | Downloads JNI libs from GitHub releases (for end users) |
+| **Local** | `runanywhere.useLocalNatives=true` | Uses JNI libs from `src/androidMain/jniLibs/` (for development) |
+| **Remote** | `runanywhere.useLocalNatives=false` | Downloads JNI libs from GitHub releases (for end users) |
 
 When you run `--setup`, the script automatically sets `testLocal=true`.
 

sdk/runanywhere-kotlin/docs/KOTLIN_MAVEN_CENTRAL_PUBLISHING.md

@@ -110,7 +110,7 @@ export MAVEN_CENTRAL_PASSWORD="<PASSWORD>"
 export ANDROID_HOME="$HOME/Library/Android/sdk"
 
 ./gradlew clean publishAllPublicationsToMavenCentralRepository \
-  -Prunanywhere.testLocal=false \
+  -Prunanywhere.useLocalNatives=false \
   -Prunanywhere.nativeLibVersion=0.17.5 \
   --no-daemon
 ```
@@ -156,7 +156,7 @@ export MAVEN_CENTRAL_USERNAME="<USERNAME>"
 export MAVEN_CENTRAL_PASSWORD="<PASSWORD>"
 
 ./gradlew clean publishAllPublicationsToMavenCentralRepository \
-  -Prunanywhere.testLocal=true \
+  -Prunanywhere.useLocalNatives=true \
   --no-daemon
 ```
 

sdk/runanywhere-kotlin/modules/runanywhere-core-llamacpp/README.md

@@ -179,7 +179,7 @@ Native libraries are automatically downloaded from GitHub releases:
 
 ```kotlin
 // gradle.properties
-runanywhere.testLocal=false  // Downloads from releases
+runanywhere.useLocalNatives=false  // Downloads from releases
 runanywhere.coreVersion=0.1.4
 ```
 
@@ -189,7 +189,7 @@ For developing with local C++ builds:
 
 ```kotlin
 // gradle.properties
-runanywhere.testLocal=true   // Uses local jniLibs/
+runanywhere.useLocalNatives=true   // Uses local jniLibs/
 ```
 
 Then build the native libraries: