From ad3c76b3a4376df1cbfb0a8da1a6ea28891b5778 Mon Sep 17 00:00:00 2001
From: Simon Binder <simon@journeyapps.com>
Date: Wed, 2 Jul 2025 11:25:28 -0600
Subject: [PATCH] Mention metro workaround for op-sqlite

---
 packages/powersync-op-sqlite/README.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/powersync-op-sqlite/README.md b/packages/powersync-op-sqlite/README.md
index e086efc62..0a8d1177c 100644
--- a/packages/powersync-op-sqlite/README.md
+++ b/packages/powersync-op-sqlite/README.md
@@ -16,6 +16,10 @@ Follow the installation instructions for the [React Native SDK](https://github.c
 npx expo install @powersync/op-sqlite
 ```
 
+When using this package without a frameowrk like Expo, we recommend adding [this metro config](https://github.com/powersync-ja/powersync-js/tree/main/packages/react-native#metro-config-optional)
+to avoid issues related to bundling PowerSync.
+Without it, you may be getting `TypeError: Cannot read property 'PowerSyncDatabase' of undefined` or similar errors.
+
 ### Install Peer Dependency:
 
 This SDK currently requires `@op-engineering/op-sqlite` as a peer dependency.