Add testing instructions to Readme

Author: benitav

packages/powersync/README.md

@@ -1,6 +1,73 @@
 # PowerSync SDK for Dart/Flutter
 
-[PowerSync](https://powersync.co) is a service and set of SDKs that keeps PostgreSQL databases in sync with on-device SQLite databases.
+[PowerSync](https://powersync.com) is a service and set of SDKs that keeps PostgreSQL databases in sync with on-device SQLite databases.
+
+## *** Web support - Open alpha ***
+
+Web support is currently in an alpha release. This Readme has been updated to reflect updates that are currently only relevant to this alpha release.
+
+### Demo app
+
+The easiest way to test out the alpha is to run the [Supabase Todo-List](./demos/supabase-todolist) demo app:
+
+1. Checkout the powersync.dart repo's `alpha_release`` branch. 
+  * Note: If you are an existing user updating to the latest code after a git pull, run `melos exec 'flutter pub upgrade'` in the project's root and make sure it succeeds.
+2. Run `melos prepare` in the project's root 
+3. cd into the `demos/supabase-todolist` folder 
+4. If you haven’t yet: `cp lib/app_config_template.dart lib/app_config.dart` (optionally update this config with your own Supabase and PowerSync project details).
+5. Run `flutter run -d chrome`
+
+### Installing PowerSync in your own project
+
+Install the latest alpha version of the package, for example:
+
+```flutter pub add powersync:1.3.0-alpha.1```
+
+### Additional config
+Web support requires `sqlite3.wasm` and `powersync_db.worker.js` assets to be served from the web application. This is typically achieved by placing the files in the project `web` directory.
+
+- `sqlite3.wasm` can be found [here](https://github.com/simolus3/sqlite3.dart/releases)
+- `powersync_db.worker.js` can be found in the repo's [releases](https://github.com/powersync-ja/powersync.dart/releases) page.
+
+Currently the Drift SQLite library is used under the hood for DB connections. See [here](https://drift.simonbinder.eu/web/#getting-started) for detailed compatibility
+and setup notes.
+
+The same code is used for initializing native and web `PowerSyncDatabase` clients.
+
+### Getting started
+Follow the [Getting Started](#getting-started) steps further down in this Readme to implement a backend connector and initialize the PowerSync database in your app, and hook PowerSync up with your app's UI.
+
+### Limitations
+
+The API for web is essentially the same as for native platforms. Some features within `PowerSyncDatabase` clients are not available.
+
+Multiple tab support is not yet available. Using multiple tabs will break.
+
+#### Imports
+
+Flutter Web does not support importing directly from `sqlite3.dart` as it uses `dart:ffi`.
+
+Change imports from
+
+```Dart
+import 'package/powersync/sqlite3.dart`
+```
+
+to
+
+```Dart
+import 'package/powersync/sqlite3_common.dart'
+```
+
+In code which needs to run on the Web platform. Isolated native specific code can still import from `sqlite3.dart`.
+
+#### Database connections
+
+Web DB connections do not support concurrency. A single DB connection is used. `readLock` and `writeLock` contexts do not
+implement checks for preventing writable queries in read connections and vice-versa.
+
+Direct access to the synchronous `CommonDatabase` (`sqlite.Database` equivalent for web) connection is not available. `computeWithDatabase` is not available on web.
+
 
 ## SDK Features
 
@@ -11,18 +78,18 @@
 - No need for client-side database migrations - these are handled automatically.
 - Subscribe to queries for live updates.
 
-## Examples
 
-For complete app examples, see our [example app gallery](https://docs.powersync.com/resources/demo-apps-example-projects#flutter)
-
-For examples of some common patterns, see our [example snippets](./example/README.md)
 
 ## Getting started
 
 You'll need to create a PowerSync account and set up a PowerSync instance. You can do this at [https://www.powersync.com/](https://www.powersync.com/).
 
 ### Install the package
+To test web support, install the latest alpha version of the SDK, for example:
+
+```flutter pub add powersync:1.3.0-alpha.1```
 
+If you want to install the latest stable version of the SDK, run:
 `flutter pub add powersync`
 
 ### Implement a backend connector and initialize the PowerSync database
@@ -155,49 +222,4 @@ Logger.root.onRecord.listen((record) {
 });
 ```
 
-## Web support
-
-Web support is currently in an alpha release.
-
-### Setup
-
-Web support requires `sqlite3.wasm` and `powersync_db.worker.js` assets to be served from the web application. This is typically achieved by placing the files in the project `web` directory.
-
-- `sqlite3.wasm` can be found [here](https://github.com/simolus3/sqlite3.dart/releases)
-- `powersync_db.worker.js` can be found in the repo's [releases](https://github.com/powersync-ja/powersync.dart/releases) page.
-
-Currently the Drift SQLite library is used under the hood for DB connections. See [here](https://drift.simonbinder.eu/web/#getting-started) for detailed compatibility
-and setup notes.
-
-The same code is used for initializing native and web `PowerSyncDatabase` clients.
-
-### Limitations
-
-The API for web is essentially the same as for native platforms. Some features within `PowerSyncDatabase` clients are not available.
 
-#### Imports
-
-Flutter Web does not support importing directly from `sqlite3.dart` as it uses `dart:ffi`.
-
-Change imports from
-
-```Dart
-import 'package/powersync/sqlite3.dart`
-```
-
-to
-
-```Dart
-import 'package/powersync/sqlite3_common.dart'
-```
-
-In code which needs to run on the Web platform. Isolated native specific code can still import from `sqlite3.dart`.
-
-#### Database connections
-
-Web DB connections do not support concurrency. A single DB connection is used. `readLock` and `writeLock` contexts do not
-implement checks for preventing writable queries in read connections and vice-versa.
-
-Direct access to the synchronous `CommonDatabase` (`sqlite.Database` equivalent for web) connection is not available. `computeWithDatabase` is not available on web.
-
-Multiple tab support is not yet available. Using multiple tabs will break.