feat(expo-plugin): Introduce expo plugin (#1250)

* scaffold

* scaffold expo example

* move tests around

* implementation

* fix expo example

* docs

* format

* docs(changeset): initial release of the plugin

* fix lint

Author: krizzu

.changeset/blue-ears-flash.md

@@ -0,0 +1,5 @@
+---
+"@react-native-async-storage/expo-with-async-storage": major
+---
+
+initial release of the plugin

.changeset/config.json

@@ -11,6 +11,7 @@
     "@react-native-async-storage/eslint-config",
     "example-react-native",
     "example-web",
-    "example-common-tests"
+    "example-common-tests",
+    "example-expo"
   ]
 }

README.md

@@ -1,7 +1,9 @@
 # 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.
+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
 
@@ -88,8 +90,6 @@ async function demo() {
 }
 ```
 
-Head over to [Usage page](api/usage.md) to learn more.
-
 ## License
 
 MIT

docs/integrations/expo.md

@@ -0,0 +1 @@
+../../packages/expo-with-async-storage/README.md

examples/common-tests/package.json

@@ -2,15 +2,18 @@
   "name": "example-common-tests",
   "version": "0.0.1",
   "private": true,
-  "main": "src/index.ts",
+  "exports": {
+    ".": "./src/index.ts",
+    "./app": "./src/App.tsx"
+  },
   "installConfig": {
     "hoistingLimits": "workspaces"
   },
   "scripts": {
     "test:lint": "eslint .",
     "test:ts": "tsc"
   },
-  "dependencies": {
+  "peerDependencies": {
     "@react-native-async-storage/async-storage": "workspace:*",
     "react": "19.0.0"
   },
@@ -21,6 +24,7 @@
     "eslint": "9.34.0",
     "lodash.isequal": "4.5.0",
     "prettier": "3.6.2",
+    "react-native-safe-area-context": "^5.6.1",
     "typescript": "5.9.2"
   }
 }

examples/react-native/src/App.tsx examples/common-tests/src/App.tsxexamples/react-native/src/App.tsx renamed to examples/common-tests/src/App.tsx

@@ -1,11 +1,10 @@
 import React, { useState } from "react";
-import { StatusBar, useColorScheme, View, Text, Platform } from "react-native";
+import { Platform, StatusBar, Text, useColorScheme, View } from "react-native";
 import { SafeAreaProvider, SafeAreaView } from "react-native-safe-area-context";
 import { TabButton } from "./components/TabButton";
 import BasicTests from "./tests/BasicTests";
-import PerformanceTests from "./tests/PerformanceTest";
 
-function App(): React.JSX.Element {
+export function TestApp(): React.JSX.Element {
   const isDarkMode = useColorScheme() === "dark";
   const [example, setExample] = useState<
     "basic" | "legacy-basic" | "perf" | "legacy-perf"
@@ -28,7 +27,6 @@ function App(): React.JSX.Element {
         <Text style={{ fontSize: 24, color: "red" }}>
           Platform: {getPlatform()}
         </Text>
-
         <View
           style={{
             alignItems: "center",
@@ -61,24 +59,8 @@ function App(): React.JSX.Element {
             onPress={() => setExample("legacy-perf")}
           />
         </View>
-
-        {(() => {
-          switch (example) {
-            case "basic":
-              return <BasicTests key={example} storageName="test-db-storage" />;
-            case "legacy-basic":
-              return <BasicTests key={example} storageName={null} />;
-            case "perf":
-              return (
-                <PerformanceTests key={example} storageName="test-db-storage" />
-              );
-            case "legacy-perf":
-              return <PerformanceTests key={example} storageName={null} />;
-          }
-        })()}
+        <BasicTests key={example} storageName="test-db-storage" />
       </SafeAreaView>
     </SafeAreaProvider>
   );
 }
-
-export default App;

…eact-native/src/components/TabButton.tsx …ommon-tests/src/components/TabButton.tsxexamples/react-native/src/components/TabButton.tsx renamed to examples/common-tests/src/components/TabButton.tsx examples/react-native/src/components/TabButton.tsx renamed to examples/common-tests/src/components/TabButton.tsx

@@ -1,5 +1,6 @@
 import React from "react";
-import { useBasicTest, useTestStorage } from "example-common-tests";
+import { useTestStorage } from "../useTestStorage";
+import { useBasicTest } from "../cases/basic";
 import { TestRunnerView } from "../components/TestRunnerView";
 
 type Props = {

…native/src/components/TestRunnerView.tsx …-tests/src/components/TestRunnerView.tsxexamples/react-native/src/components/TestRunnerView.tsx renamed to examples/common-tests/src/components/TestRunnerView.tsx examples/react-native/src/components/TestRunnerView.tsx renamed to examples/common-tests/src/components/TestRunnerView.tsx

@@ -1,5 +1,6 @@
 import React from "react";
-import { usePerformanceTest, useTestStorage } from "example-common-tests";
+import { useTestStorage } from "../useTestStorage";
+import { usePerformanceTest } from "../cases/performance.tsx";
 import { TestRunnerView } from "../components/TestRunnerView";
 
 type Props = {