docs: info about min version

Author: krizzu

README.md

@@ -1,9 +1,8 @@
 # React Native Async Storage
 
-Async Storage is asynchronous, unencrypted, persistent, key-value storage for your React Native application.  
-It provides a simple API compatible with the [Web Storage API](https://developer.mozilla.org/en-US/docs/Web/API/Web_Storage_API), with a few extensions for batch operations and multi-database support.
+Async Storage is an asynchronous, unencrypted, persistent key-value storage solution for your React Native application.
+It provides a simple API compatible with the [Web Storage API]((https://developer.mozilla.org/en-US/docs/Web/API/Web_Storage_API)), with additional extensions for batch operations and multi-database support.
 
----
 
 ## Supported platforms
 
@@ -13,19 +12,49 @@ It provides a simple API compatible with the [Web Storage API](https://developer
 - **macOS** (SQLite backend via Room KMP)
 - **Windows** (legacy fallback, single database only)
 
+
+## Supported versions
+
+| Component       | Minimum Version |
+|-----------------|-----------------|
+| React Native    | 0.76            |
+| Kotlin          | 2.1.0           |
+| KSP             | 2.1.0-1.0.28    |
+| Android min sdk | 24              |
+
+
 ---
 
 ## Installation
 
 ```shell
-# using npm
+# Using npm
 npm install @react-native-async-storage/async-storage
 
-# using yarn
+# Using yarn
 yarn add @react-native-async-storage/async-storage
 ```
 
-On iOS/macOS, don’t forget to install pods:
+### Android
+
+Inside your `android/build.gradle(.kts)` file, add link to local maven repo:
+
+```groovy
+allprojects {
+    repositories {
+        // ... others like google(), mavenCentral()
+
+        maven {
+            // or uri("path/to/node_modules/@react-native-async-storage/async-storage/android/local_repo")
+            url = uri(project(":react-native-async-storage_async-storage").file("local_repo"))
+        }
+    }
+}
+```
+
+### iOS/macOS
+
+Install cocoapods dependencies:
 
 ```shell
 # inside macos/ios directory
@@ -34,12 +63,10 @@ pod install
 
 ## Usage
 
-### Basic
-
 ```typescript
 import { createAsyncStorage } from "@react-native-async-storage/async-storage";
 
-// Create a storage instance
+// create a storage instance
 const storage = createAsyncStorage("appDB");
 
 async function demo() {
@@ -48,41 +75,16 @@ async function demo() {
 
   // read value stored at "userToken" key
   const token = await storage.getItem("userToken");
-  console.log("Stored token:", token);
+  console.log("Stored token:", token); // abc123
 
   // remove value from storage
   await storage.removeItem("userToken");
 }
 ```
 
-### Multi-item operations
-
-Async Storage supports batch operations for efficiency:
-
-```typescript
-async function demo() {
-  // save multiple values at once
-  await storage.setMany({
-    theme: "dark",
-    language: "en",
-  });
-
-  // Retrieve multiple values
-  const values = await storage.getMany(["theme", "language", "different"]);
-  console.log(values); // { theme: "dark", language: "en", different: null }
-
-  // Remove multiple values
-  await storage.removeMany(["theme", "language"]);
-}
-```
-
-## Contribution
-
-Pull requests are welcome. Please open an issue first to discuss what you would
-like to change.
+Head over to [Usage page](api/usage.md) to learn more.
 
-See the [CONTRIBUTING](.github/CONTRIBUTING.md) file for more information.
 
 ## License
 
-MIT
+MIT

docs/index.md

@@ -2,20 +2,30 @@
 title: Overview
 ---
 
-# Async Storage
+# React Native Async Storage
 
 Async Storage is an asynchronous, unencrypted, persistent key-value storage solution for your React Native application.
 It provides a simple API compatible with the [Web Storage API]((https://developer.mozilla.org/en-US/docs/Web/API/Web_Storage_API)), with additional extensions for batch operations and multi-database support.
 
----
 
-## Supported Platforms
+## Supported platforms
 
 - **Android** (SQLite backend via Room KMP)
 - **iOS** (SQLite backend via Room KMP)
 - **Web** (IndexedDB backend)
 - **macOS** (SQLite backend via Room KMP)
-- **Windows** (legacy fallback, single-database only)
+- **Windows** (legacy fallback, single database only)
+
+
+## Supported versions
+
+| Component       | Minimum Version |
+|-----------------|-----------------|
+| React Native    | 0.76            |
+| Kotlin          | 2.1.0           |
+| KSP             | 2.1.0-1.0.28    |
+| Android min sdk | 24              |
+
 
 ---
 
@@ -77,3 +87,8 @@ async function demo() {
 ```
 
 Head over to [Usage page](api/usage.md) to learn more.
+
+
+## License
+
+MIT

packages/async-storage/android/build.gradle

@@ -21,7 +21,7 @@ apply plugin: "com.android.library"
 apply plugin: "kotlin-android"
 apply plugin: "com.facebook.react"
 
-// to support migration from old storage
+// ksp/room is required to support legacy storage
 apply plugin: 'com.google.devtools.ksp'
 
 def getExtOrDefault(name) {
@@ -94,6 +94,7 @@ dependencies {
     implementation "org.asyncstorage.shared_storage:storage-android:1.0.0"
 
 
+    // ksp/room is required to support legacy storage
     def room_version = getExtOrDefault("ROOM_VERSION")
     implementation "androidx.room:room-runtime:$room_version"
     implementation "androidx.room:room-ktx:$room_version"

packages/async-storage/package.json

@@ -34,7 +34,11 @@
     "!**/__tests__",
     "!**/__fixtures__",
     "!**/__mocks__",
-    "!**/.*"
+    "!**/.*",
+    "!docs",
+    "!examples",
+    "!scripts",
+    "!shared-storage"
   ],
   "dependencies": {
     "idb": "8.0.3"