react-native-model-viewer-webview 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -5,6 +5,29 @@ All notable changes to this package should be documented here.
 This project uses semantic versioning. Versions below `1.0.0` may still change
 minor APIs when the release notes call it out clearly.
 
+## 0.2.1 - 2026-06-30
+
+This is a docs and confidence release. There are no runtime API changes.
+
+### Documentation
+
+- Add Android Expo Go smoke-test notes for remote GLB loading and local GLB
+  loading.
+- Document the local Expo asset path that worked in testing: resolve the
+  bundled `.glb`, read it as base64, and pass a
+  `data:model/gltf-binary;base64,...` URI to `ModelViewerWebView`.
+- Call out that direct Android WebView loading from a local `file:` GLB URI was
+  not reliable in this smoke test.
+- Add a verified smoke-test table to the README and compatibility docs, with
+  iOS WKWebView still marked as not yet tested.
+- Add the Android local-GLB screenshot and compatibility section to the public
+  docs site.
+
+### Maintenance
+
+- Update docs-site tests so the new local-GLB guidance and smoke-test evidence
+  stay present.
+
 ## 0.2.0 - 2026-06-02
 
 ### Added

package/README.md

@@ -122,6 +122,31 @@ await carModel.downloadAsync();
 `localUri` is preferred over `uri` when both exist. `modelUri` is still accepted
 as a string-only compatibility prop.
 
+For Android Expo Go, direct `file:` loading from WebView can be unreliable. The
+verified local-asset path is to read the Expo asset as base64 and pass a GLB
+data URI:
+
+```tsx
+import { Asset } from "expo-asset";
+import * as FileSystem from "expo-file-system/legacy";
+import { ModelViewerWebView } from "react-native-model-viewer-webview";
+
+const model = Asset.fromModule(require("./assets/model.glb"));
+await model.downloadAsync();
+
+const localUri = model.localUri ?? model.uri;
+const base64 = await FileSystem.readAsStringAsync(localUri, {
+  encoding: FileSystem.EncodingType.Base64,
+});
+const modelSource = `data:model/gltf-binary;base64,${base64}`;
+
+<ModelViewerWebView modelSource={modelSource} style={{ height: 320 }} />;
+```
+
+This data-URI path was smoke-tested on Android Expo Go with a local Khronos
+`Box.glb` asset. Use `file:` URIs only after testing them on your target
+WebView/device matrix.
+
 ## Metro Setup For Local GLB Files
 
 If your app imports `.glb` files, add `glb` to Metro's asset extensions.
@@ -196,6 +221,15 @@ Or pass an inline module script if your build already bundles the source:
 />
 ```
 
+## Verified Smoke Tests
+
+| Platform | App runtime | Model source | Result |
+| --- | --- | --- | --- |
+| Android 16 physical device | Expo Go, Expo SDK 56 tester app | Remote GLB URL | Verified |
+| Android 16 physical device | Expo Go, Expo SDK 56 tester app | Local Khronos `Box.glb` as `data:model/gltf-binary;base64,...` | Verified |
+| Android 16 physical device | Expo Go, Expo SDK 56 tester app | Local Khronos `Box.glb` as direct `file:` URI | Not reliable in this smoke test |
+| iOS WKWebView | Not yet tested | Any model source | Not yet verified |
+
 ## Props
 
 `ModelViewerWebView` accepts all `react-native-webview` props except `source` and

package/docs/COMPATIBILITY.md

@@ -40,6 +40,22 @@ Automated checks validate:
 - package tarball contents with `npm pack --dry-run`
 - integration with this repository's Expo app through TypeScript and Expo lint
 
+## Device Smoke Tests
+
+These results are manual smoke tests, not a blanket support matrix.
+
+| Date | Platform | App runtime | Model source | Result |
+| --- | --- | --- | --- | --- |
+| 2026-06-30 | Android 16 physical device | Expo Go, Expo SDK 56 tester app | Remote GLB URL | Verified |
+| 2026-06-30 | Android 16 physical device | Expo Go, Expo SDK 56 tester app | Local Khronos `Box.glb` as `data:model/gltf-binary;base64,...` | Verified |
+| 2026-06-30 | Android 16 physical device | Expo Go, Expo SDK 56 tester app | Local Khronos `Box.glb` as direct `file:` URI | Not reliable in this smoke test |
+| Not yet tested | iOS WKWebView | Not yet tested | Any model source | Not yet verified |
+
+The local Android test used `expo-asset` to resolve a bundled `.glb`, then
+`expo-file-system` to read the local file as base64 before passing a
+`data:model/gltf-binary;base64,...` URI to `ModelViewerWebView`. This avoids the
+Android WebView file-access path that failed in the direct `file:` smoke test.
+
 ## Not Guaranteed
 
 The package does not claim blanket support for all React Native versions.
@@ -50,6 +66,9 @@ Explicit limitations:
 - WebView bugs in specific Android System WebView or iOS versions may affect
   rendering.
 - Local `.glb` bundling depends on the consuming app's Metro config.
+- On Android Expo Go, direct WebView loading from a local `file:` GLB URI was
+  not reliable in the 2026-06-30 smoke test. Prefer a GLB data URI for local
+  Expo assets unless your target app/device matrix proves direct file loading.
 - Device rendering is not fully proven by unit tests.
 - AR behavior is not a supported package guarantee.
 - Long lists of many WebViews may have memory/performance problems.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-model-viewer-webview",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "A WebView-backed GLB and glTF model viewer for React Native and Expo.",
   "license": "MIT",
   "repository": {