diff --git a/client-sdks/orms/kotlin/room.mdx b/client-sdks/orms/kotlin/room.mdx index 6d0b3b45..162d16ff 100644 --- a/client-sdks/orms/kotlin/room.mdx +++ b/client-sdks/orms/kotlin/room.mdx @@ -26,6 +26,10 @@ When adopting the Room integration for PowerSync: ## Installation + +Version 1.14.1 and later of `com.powersync:integration-room` requires [Room 3.0](https://developer.android.com/jetpack/androidx/releases/room3). If your app still uses Room 2.x, upgrade your Room dependency to 3.0 before updating the integration. + + PowerSync acts as an addon to your existing Room database, which means that (unlike with most other PowerSync SDKs) you are still responsible for schema management. Room requires [raw tables](/client-sdks/advanced/raw-tables), as the views managed by PowerSync are incompatible with diff --git a/client-sdks/reference/kotlin.mdx b/client-sdks/reference/kotlin.mdx index c76fbf51..f69c3dfd 100644 --- a/client-sdks/reference/kotlin.mdx +++ b/client-sdks/reference/kotlin.mdx @@ -40,6 +40,7 @@ import LocalOnly from '/snippets/local-only-escape.mdx'; **Supported platforms** * PowerSync supports Android, JVM and Apple (iOS, macOS, tvOS, watchOS) targets through Kotlin Multiplatform. * On the JVM, the following platforms are supported: Linux AArch64, Linux X64, MacOS AArch64, MacOS X64, Windows X64. + * Web (JS and WebAssembly) targets have experimental support. See [Experimental Web Support](#experimental-web-support). ## Getting Started @@ -374,6 +375,18 @@ The PowerSync SDK for Kotlin can be used with the SQLDelight and Room libraries, run SQL queries. For details, see the [SQL Library Support](/client-sdks/orms/kotlin/overview) page. +## Experimental Web Support + +Version 1.14.1 of the SDK adds initial support for web targets (JS and WebAssembly). Use `WebConnectionFactory` to open a PowerSync database on the web. + + +Web support is experimental and incomplete. We are sharing it for early testing and prototyping purposes, and it is not ready for production use. The main limitation is that multi-tab support is not functional in this version: tabs don't coordinate sync connections or share update notifications, so use the database from a single tab only. + +If you try web support, please test it thoroughly and report any issues you run into on [GitHub](https://github.com/powersync-ja/powersync-kotlin/issues). Follow the [tracking issue](https://github.com/powersync-ja/powersync-kotlin/issues/362) for progress on stabilizing web support. + + +For a working example, see the web target of the [Supabase To-Do List demo](https://github.com/powersync-ja/powersync-kotlin/tree/main/demos/supabase-todolist). + ## Troubleshooting See [Troubleshooting](/debugging/troubleshooting) for pointers to debug common issues. diff --git a/resources/supported-platforms.mdx b/resources/supported-platforms.mdx index 7620e89c..3818c3cb 100644 --- a/resources/supported-platforms.mdx +++ b/resources/supported-platforms.mdx @@ -119,8 +119,8 @@ The Node SDK supports all [non-EOL Node.js versions](https://nodejs.org/en/about | macOS (JVM) | Yes (x86-64, aarch64) | | | | Linux (native) | No | – | Maybe soon | | Windows (native) | No | – | Maybe soon | -| JS | No | – | | -| WebAssembly | No | – | | +| JS | Experimental | – | Added in SDK v1.14.1. Unstable and not ready for production — see [Experimental Web Support](/client-sdks/reference/kotlin#experimental-web-support). | +| WebAssembly | Experimental | – | Added in SDK v1.14.1. Unstable and not ready for production — see [Experimental Web Support](/client-sdks/reference/kotlin#experimental-web-support). | | HTTP connection method | Yes | – | | | WebSocket connection method | Yes | – | Note: Only as an automated fallback for clients without backpressure support. |