@@ -13,7 +13,7 @@ Expo Go is a sandbox environment that allows you to quickly test your applicatio
 <Warning>
   This package is in an **alpha** release.
 
-  **Expo Go Sandbox Environment Only** This adapter is specifically designed for Expo Go and similar JavaScript-only environments. It will be much slower than native database adapters and has limitations. Every write operation triggers a complete rewrite of the entire database file to persistent storage, not just the changed data. In addition to the performance overheads, this adapter doesn't provide any of the SQLite consistency guarantees - you may end up with missing data or a corrupted database file if the app is killed while writing to the database file.
+  **Expo Go Sandbox Environment Only** This adapter is specifically designed for Expo Go and similar JavaScript-only environments. It will be much slower than native database adapters and doesn't support persistence reliably.
 </Warning>
 
 ## Usage
@@ -115,6 +115,14 @@ After adding PowerSync to your app:
 
 ## Data Persistence
 
+<Warning>
+Support for persistence with `adapter-sql-js` is deprecated. The reason is that the implementation is inefficient,
+doesn't provide consistency guarantees expected from SQLite, and doesn't work while the database is connected.
+
+If you need persisted data across app restarts, use the [recommended setup](/client-sdks/reference/react-native-and-expo#installation)
+with a local app build instead of Expo Go.
+</Warning>
+
 The default version of this adapter uses in-memory persistence, but you can specify your own `persister` option to the open factory. See an example in the package [README](https://www.npmjs.com/package/@powersync/adapter-sql-js).
 
 ## Moving Beyond Expo Go