Readme polish

Author: benitav

README.md

@@ -34,6 +34,10 @@
 
   - Kysely integration (ORM) for React Native and JavaScript/TypeScript projects.
 
+- [packages/powersync-op-sqlite](./packages/powersync-op-sqlite/README.md)
+
+  - OP-SQLite integration for React Native projects.  
+
 - [packages/common](./packages/common/README.md)
   - Shared package: TypeScript implementation of a PowerSync database connector and streaming sync bucket implementation.
 

packages/powersync-op-sqlite/README.md

@@ -1,26 +1,26 @@
-<p align="center">
-  <a href="https://www.powersync.com" target="_blank"><img src="https://github.com/powersync-ja/.github/assets/7372448/d2538c43-c1a0-4c47-9a76-41462dba484f"/></a>
-</p>
+# OP-SQLite Factory for the PowerSync React Native SDK
 
-# PowerSync SDK for React Native
+## Overview
 
-_[PowerSync](https://www.powersync.com) is a sync engine for building local-first apps with instantly-responsive UI/UX and simplified state transfer. Syncs between SQLite on the client-side and Postgres or MongoDB on the server-side (MySQL coming soon)._
+This package (`packages/powersync-op-sqlite`) enables using [OP-SQLite](https://github.com/op-engineering/op-sqlite) with PowerSync alongside the [React Native SDK](../react-native/README.md). 
 
-This package (`packages/powersync-op-sqlite`) enables using OP-SQLite with PowerSync. It is an extension of `packages/common`.
+If you are not yet familiar with PowerSync, please see the [PowerSync React Native SDK](../react-native/README.md) for more information.
 
-## Alpha release
+### Alpha release
 
 This package is currently in an alpha release. If you find a bug or issue, please open a [GitHub issue](https://github.com/powersync-ja/powersync-js/issues). Questions or feedback can be posted on our [community Discord](https://discord.gg/powersync) - we'd love to hear from you.
 
-# Installation
+## Installation
 
-## Install Package
+Follow the installation instructions for the [React Native SDK](../react-native/README.md) if you haven't yet set up PowerSync in your project. However, note that this package cannot be installed alongside `@journeyapps/react-native-quick-sqlite`. Skip the step about installing it as a peer dependency, or uninstall it if it is already installed.
+
+### Install Package
 
 ```bash
 npx expo install @powersync/op-sqlite
 ```
 
-## Install Peer Dependency: SQLite
+### Install Peer Dependency:
 
 This SDK currently requires `@op-engineering/op-sqlite` as a peer dependency.
 
@@ -30,8 +30,6 @@ Install it in your app with:
 npx expo install @op-engineering/op-sqlite
 ```
 
-**Note**: This package cannot be installed alongside `@journeyapps/react-native-quick-sqlite`. Please ensure you do **not** install both packages at the same time.
-
 ## Usage
 
 ```typescript
@@ -45,7 +43,7 @@ const factory = new OPSqliteOpenFactory({
 this.powersync = new PowerSyncDatabase({ database: factory, schema: AppSchema });
 ```
 
-# Native Projects
+## Native Projects
 
 This package uses native libraries. Create native Android and iOS projects (if not created already) by running:
 
@@ -54,25 +52,3 @@ npx expo run:android
 # OR
 npx expo run:ios
 ```
-
-# Getting Started
-
-Our [SDK reference](https://docs.powersync.com/client-sdk-references/react-native-and-expo) contains everything you need to know to get started implementing PowerSync in your project.
-
-# Changelog
-
-A changelog for this SDK is available [here](https://releases.powersync.com/announcements/react-native-client-sdk).
-
-# API Reference
-
-The full API reference for this SDK can be found [here](https://powersync-ja.github.io/powersync-js/react-native-sdk).
-
-# Examples
-
-For example projects built with PowerSync and React Native, see our [Demo Apps / Example Projects](https://docs.powersync.com/resources/demo-apps-example-projects#react-native-and-expo) gallery. Most of these projects can also be found in the [`demos/`](../demos/) directory.
-
-# Found a bug or need help?
-
-- Join our [Discord server](https://discord.gg/powersync) where you can browse topics from our community, ask questions, share feedback, or just say hello :)
-- Please open a [GitHub issue](https://github.com/powersync-ja/powersync-js/issues) when you come across a bug.
-- Have feedback or an idea? [Submit an idea](https://roadmap.powersync.com/tabs/5-roadmap/submit-idea) via our public roadmap or [schedule a chat](https://calendly.com/powersync-product/powersync-chat) with someone from our product team.

packages/react-native/README.md

@@ -20,7 +20,7 @@ npx expo install @powersync/react-native
 
 ## Install Peer Dependency: SQLite
 
-This SDK currently requires `@journeyapps/react-native-quick-sqlite` as a peer dependency.
+By default, this SDK requires `@journeyapps/react-native-quick-sqlite` as a peer dependency. Alternatively, you can install OP-SQLite from the [PowerSync OP-SQLite package](../powersync-op-sqlite/README.md) (currently in alpha).
 
 Install it in your app with: