feat: add modular resource fetcher adapters for Expo and bare React Native

.cspell-wordlist.txt

@@ -95,3 +95,4 @@ Português
 codegen
 cstdint
 ocurred
+RNFS

.github/workflows/ci.yml

@@ -24,7 +24,11 @@ jobs:
         run: yarn lint
 
       - name: Typecheck files
-        run: yarn typecheck
+        run: |
+          cd packages/react-native-executorch
+          yarn prepare
+          cd ../../
+          yarn typecheck
 
   build-library:
     runs-on: ubuntu-latest

.nvmrc

@@ -1 +1 @@
-v20
+v22

apps/computer-vision/app/_layout.tsx

@@ -1,4 +1,7 @@
 import { Drawer } from 'expo-router/drawer';
+import { initExecutorch } from 'react-native-executorch';
+import { ExpoResourceFetcher } from '@rn-executorch/expo-adapter';
+
 import ColorPalette from '../colors';
 import React, { useState } from 'react';
 import { Text, StyleSheet, View } from 'react-native';
@@ -10,6 +13,10 @@ import {
 } from '@react-navigation/drawer';
 import { GeneratingContext } from '../context';
 
+initExecutorch({
+  resourceFetcher: ExpoResourceFetcher,
+});
+
 interface CustomDrawerProps extends DrawerContentComponentProps {
   isGenerating: boolean;
 }

apps/computer-vision/package.json

@@ -11,17 +11,18 @@
     "lint": "eslint . --ext .ts,.tsx --fix"
   },
   "dependencies": {
-    "@react-native/metro-config": "^0.76.3",
+    "@react-native/metro-config": "^0.81.5",
     "@react-navigation/drawer": "^7.3.9",
     "@react-navigation/native": "^7.1.6",
+    "@rn-executorch/expo-adapter": "workspace:*",
     "@shopify/react-native-skia": "2.2.12",
     "expo": "^54.0.27",
     "expo-constants": "~18.0.11",
     "expo-font": "~14.0.10",
     "expo-linking": "~8.0.10",
     "expo-router": "~6.0.17",
     "expo-status-bar": "~3.0.9",
-    "metro-config": "^0.81.0",
+    "metro-config": "^0.81.5",
     "react": "19.1.0",
     "react-native": "0.81.5",
     "react-native-device-info": "^14.0.4",

apps/computer-vision/tsconfig.json

@@ -9,7 +9,8 @@
     "customConditions": ["react-native"],
     "noEmit": true,
     "paths": {
-      "react-native-executorch": ["../../packages/react-native-executorch/src"]
+      "react-native-executorch": ["../../packages/react-native-executorch/src"],
+      "@rn-executorch/expo-adapter": ["../../packages/expo-adapter/src"]
     }
   }
 }

apps/llm/app/_layout.tsx

@@ -1,15 +1,20 @@
 import { Drawer } from 'expo-router/drawer';
+import { initExecutorch } from 'react-native-executorch';
+import { ExpoResourceFetcher } from '@rn-executorch/expo-adapter';
 import ColorPalette from '../colors';
 import React, { useState } from 'react';
 import { Text, StyleSheet, View } from 'react-native';
-
 import {
   DrawerContentComponentProps,
   DrawerContentScrollView,
   DrawerItemList,
 } from '@react-navigation/drawer';
 import { GeneratingContext } from '../context';
 
+initExecutorch({
+  resourceFetcher: ExpoResourceFetcher,
+});
+
 interface CustomDrawerProps extends DrawerContentComponentProps {
   isGenerating: boolean;
 }

apps/llm/package.json

@@ -11,9 +11,10 @@
     "lint": "eslint . --ext .ts,.tsx --fix"
   },
   "dependencies": {
-    "@react-native/metro-config": "^0.76.3",
+    "@react-native/metro-config": "^0.81.5",
     "@react-navigation/drawer": "^7.3.9",
     "@react-navigation/native": "^7.1.6",
+    "@rn-executorch/expo-adapter": "workspace:*",
     "expo": "^54.0.27",
     "expo-brightness": "~14.0.8",
     "expo-calendar": "~15.0.8",
@@ -22,7 +23,7 @@
     "expo-linking": "~8.0.10",
     "expo-router": "~6.0.17",
     "expo-status-bar": "~3.0.9",
-    "metro-config": "^0.81.0",
+    "metro-config": "^0.81.5",
     "react": "19.1.0",
     "react-native": "0.81.5",
     "react-native-audio-api": "^0.8.2",

apps/llm/tsconfig.json

@@ -9,7 +9,8 @@
     "customConditions": ["react-native"],
     "noEmit": true,
     "paths": {
-      "react-native-executorch": ["../../packages/react-native-executorch/src"]
+      "react-native-executorch": ["../../packages/react-native-executorch/src"],
+      "@rn-executorch/expo-adapter": ["../../packages/expo-adapter/src"]
     }
   }
 }

apps/speech/App.tsx

@@ -5,6 +5,12 @@ import { SpeechToTextScreen } from './screens/SpeechToTextScreen';
 import ColorPalette from './colors';
 import ExecutorchLogo from './assets/executorch.svg';
 import { Quiz } from './screens/Quiz';
+import { initExecutorch } from 'react-native-executorch';
+import { ExpoResourceFetcher } from '@rn-executorch/expo-adapter';
+
+initExecutorch({
+  resourceFetcher: ExpoResourceFetcher,
+});
 
 export default function App() {
   const [currentScreen, setCurrentScreen] = useState<

apps/speech/package.json

@@ -11,12 +11,13 @@
     "lint": "eslint . --ext .ts,.tsx --fix"
   },
   "dependencies": {
-    "@react-native/metro-config": "^0.76.3",
+    "@react-native/metro-config": "^0.81.5",
+    "@rn-executorch/expo-adapter": "workspace:*",
     "buffer": "^6.0.3",
     "expo": "^54.0.27",
     "expo-font": "~14.0.10",
     "expo-status-bar": "~3.0.9",
-    "metro-config": "^0.81.0",
+    "metro-config": "^0.81.5",
     "react": "19.1.0",
     "react-native": "0.81.5",
     "react-native-audio-api": "0.6.5",

apps/speech/tsconfig.json

@@ -9,7 +9,8 @@
     "customConditions": ["react-native"],
     "noEmit": true,
     "paths": {
-      "react-native-executorch": ["../../packages/react-native-executorch/src"]
+      "react-native-executorch": ["../../packages/react-native-executorch/src"],
+      "@rn-executorch/expo-adapter": ["../../packages/expo-adapter/src"]
     }
   }
 }

apps/text-embeddings/app/_layout.tsx

@@ -1,4 +1,6 @@
 import { Drawer } from 'expo-router/drawer';
+import { initExecutorch } from 'react-native-executorch';
+import { ExpoResourceFetcher } from '@rn-executorch/expo-adapter';
 import ColorPalette from '../colors';
 import React, { useState } from 'react';
 import { Text, StyleSheet, View } from 'react-native';
@@ -10,6 +12,10 @@ import {
 } from '@react-navigation/drawer';
 import { GeneratingContext } from '../context';
 
+initExecutorch({
+  resourceFetcher: ExpoResourceFetcher,
+});
+
 interface CustomDrawerProps extends DrawerContentComponentProps {
   isGenerating: boolean;
 }

apps/text-embeddings/package.json

@@ -15,6 +15,7 @@
   },
   "dependencies": {
     "@react-navigation/drawer": "^7.3.9",
+    "@rn-executorch/expo-adapter": "workspace:*",
     "expo": "^54.0.27",
     "expo-constants": "~18.0.11",
     "expo-linking": "~8.0.10",

apps/text-embeddings/tsconfig.json

@@ -9,7 +9,8 @@
     "customConditions": ["react-native"],
     "noEmit": true,
     "paths": {
-      "react-native-executorch": ["../../packages/react-native-executorch/src"]
+      "react-native-executorch": ["../../packages/react-native-executorch/src"],
+      "@rn-executorch/expo-adapter": ["../../packages/expo-adapter/src"]
     }
   }
 }

package.json

@@ -5,7 +5,12 @@
   "workspaces": {
     "packages": [
       "packages/react-native-executorch",
-      "apps/*"
+      "packages/bare-adapter",
+      "packages/expo-adapter",
+      "apps/computer-vision",
+      "apps/llm",
+      "apps/speech",
+      "apps/text-embeddings"
     ]
   },
   "scripts": {

packages/bare-adapter/README.md

@@ -0,0 +1,30 @@
+# @rn-executorch/bare-adapter
+
+Bare React Native adapter for `react-native-executorch` that provides resource fetching capabilities using native filesystem libraries.
+
+## Installation
+
+```bash
+yarn add @rn-executorch/bare-adapter
+yarn add @dr.pogodin/react-native-fs @kesha-antonov/react-native-background-downloader
+```
+
+## Usage
+
+```typescript
+import { initExecutorch } from 'react-native-executorch';
+import { BareResourceFetcher } from '@rn-executorch/bare-adapter';
+
+initExecutorch({
+  resourceFetcher: BareResourceFetcher,
+});
+```
+
+## When to Use
+
+Use this adapter if you're working with:
+- Bare React Native projects (created with `npx @react-native-community/cli@latest init`)
+- Projects that need true background downloads
+- Projects requiring direct native filesystem access
+
+This adapter uses `@dr.pogodin/react-native-fs` and `@kesha-antonov/react-native-background-downloader` for enhanced file operations and background download support.

packages/bare-adapter/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@rn-executorch/bare-adapter",
+  "version": "0.1.0",
+  "description": "Bare React Native adapter for react-native-executorch",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "exports": {
+    ".": {
+      "import": "./src/index.ts",
+      "types": "./src/index.ts"
+    }
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint \"**/*.{js,ts,tsx}\""
+  },
+  "peerDependencies": {
+    "@dr.pogodin/react-native-fs": "^2.0.0",
+    "@kesha-antonov/react-native-background-downloader": "^4.0.0",
+    "react-native": "*",
+    "react-native-executorch": "*"
+  },
+  "devDependencies": {
+    "@dr.pogodin/react-native-fs": "^2.36.2",
+    "@kesha-antonov/react-native-background-downloader": "^4.4.5",
+    "@types/react": "~19.1.10",
+    "react": "19.1.0",
+    "react-native": "0.81.5",
+    "react-native-executorch": "workspace:*",
+    "typescript": "~5.9.2"
+  }
+}