Various polish (#214)

* add expo go new app instructions

* add node.js attachment community project

* Add compact action to list

* Rather follow existing examples around pending lists

* Wording

* Add sync rules as a next step

Author: benitav

client-sdk-references/react-native-and-expo/expo-go-support.mdx

@@ -17,23 +17,102 @@ A development package for PowerSync which uses SQL.js to provide a pure JavaScri
 
 ## Usage
 
+<Tabs>
+<Tab title="New App">
+
+### Quickstart
+
+1. Create a new Expo app:
+```bash
+npx create-expo-app@latest my-app
+```
+
+2. Navigate to your app directory and start the development server:
+```bash
+cd my-app && npm run ios
+```
+
+3. In a new terminal tab, install PowerSync dependencies:
+```bash
+npm install @powersync/react-native @powersync/adapter-sql-js
+```
+
+4. Replace the code in `app/(tabs)/index.tsx` with:
+
+```tsx app/(tabs)/index.tsx
+import { SQLJSOpenFactory } from "@powersync/adapter-sql-js";
+import { PowerSyncDatabase, Schema } from "@powersync/react-native";
+import { useEffect, useState } from "react";
+import { Text } from "react-native";
+
+export const powerSync = new PowerSyncDatabase({
+  schema: new Schema({}), // todo: define the schema - see Next Steps below
+  database: new SQLJSOpenFactory({
+    dbFilename: "example.db",
+  }),
+});
+
+export default function HomeScreen() {
+  const [version, setVersion] = useState<string | null>(null);
+
+  useEffect(() => {
+    powerSync.get("select powersync_rs_version();").then((r) => {setVersion(JSON.stringify(r))});
+  }, []);
+
+  return (
+      <>{version && <Text style={{fontSize: 24, fontWeight: 'bold'}}>PowerSync Initialized - {version}</Text>}</>
+  );
+}
+```
+
+</Tab>
+<Tab title="Existing App">
+
+1. Install the SQL.js adapter:
 ```bash
 npm install @powersync/adapter-sql-js
 ```
 
-```js SystemProvider.tsx
+2. Set up PowerSync by using the Sql.js factory:
+
+```tsx SystemProvider.tsx
 import { SQLJSOpenFactory } from "@powersync/adapter-sql-js";
-import { PowerSyncDatabase } from "@powersync/react-native";
+import { PowerSyncDatabase, Schema } from "@powersync/react-native";
+import { useEffect, useState } from "react";
+import { Text } from "react-native";
 
 export const powerSync = new PowerSyncDatabase({
-  schema: AppSchema,
+  schema: new Schema({}), // todo: define the schema - see Next Steps below
   database: new SQLJSOpenFactory({
     dbFilename: "example.db",
   }),
 });
+
+export default function HomeScreen() {
+  const [version, setVersion] = useState<string | null>(null);
+
+  useEffect(() => {
+    powerSync.get("select powersync_rs_version();").then((r) => {setVersion(JSON.stringify(r))});
+  }, []);
+
+  return (
+      <>{version && <Text style={{fontSize: 24, fontWeight: 'bold'}}>PowerSync Initialized - {version}</Text>}</>
+  );
+}
 ```
 
-### Data Persistence
+</Tab>
+</Tabs>
+
+## Next Steps
+
+After adding PowerSync to your app:
+
+1. [**Define what data to sync by setting up Sync Rules**](/usage/sync-rules) 
+2. [**Implement your SQLite client schema**](/client-sdk-references/react-native-and-expo#1-define-the-schema)
+3. [**Connect to PowerSync and your backend**](/client-sdk-references/react-native-and-expo#3-integrate-with-your-backend)
+
+## Data Persistence
 
 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).

resources/demo-apps-example-projects.mdx

@@ -148,6 +148,9 @@ This page showcases example projects organized by platform and backend technolog
   </Accordion>
 
   <Accordion title="Notable Community Projects" icon="people-carry-box">
+  <Note>
+    This is a list of projects we've spotted from community members 🙌 These projects haven't necessarily been vetted by us.
+  </Note>
   #### Custom Backends
 
   * Laravel Backend
@@ -171,6 +174,8 @@ This page showcases example projects organized by platform and backend technolog
   * Expo Web Integration
     * https://github.com/ImSingee/powersync-web-workers
     * Note: Our [React Native Web support](/client-sdk-references/react-native-and-expo/react-native-web-support) now eliminates the need to patch the `@powersync/web` module
+  * Attachments library for Node.js
+    * https://www.npmjs.com/package/@muhammedv/powersync-attachments-for-node
   </Accordion>
 </AccordionGroup>
 

usage/tools/powersync-dashboard.mdx

@@ -81,6 +81,7 @@ The various actions available in your project are accessible via the Command Pal
 - **Compare deployed sync rules** -\> Compare the [sync rules](/usage/sync-rules) as defined in your `sync-rules.yaml` file with those deployed to an instance.
 - **Save changes** -\> Save changes to files as a revision when in **Basic Revisions** version control mode (see _Version Control_ below)
   - Or **Commit changes** -\> Commit changes to files when in **Advanced Git** version control mode.
+- **Compact buckets** -\> Manually [compact](/usage/lifecycle-maintenance/compacting-buckets) and optionally [defragment](/usage/lifecycle-maintenance/compacting-buckets#defragmenting) sync buckets of an instance.
 - **Create Personal Access Token** -\> Create an access token scoped to your user, which is needed for the [CLI](/usage/tools/cli).
 - **Rename project** -\> Rename your PowerSync project.
 

usage/use-case-examples/watch-queries.mdx

@@ -403,15 +403,15 @@ This class provides advanced features:
 
 ```javascript
 // Create a shared query instance
-const sharedTodosQuery = db.query({ sql: 'SELECT * FROM todos WHERE list_id = ?', parameters: [listId] }).watch();
+const sharedListsQuery = db.query({ sql: 'SELECT * FROM lists WHERE state = ?', parameters: ['pending'] }).watch();
 
 // Multiple components can listen to the same query
-const dispose1 = sharedTodosQuery.registerListener({
-  onData: (data) => updateTodosList(data)
+const dispose1 = sharedListsQuery.registerListener({
+  onData: (data) => updatePendingListsDisplay(data)
 });
 
-const dispose2 = sharedTodosQuery.registerListener({
-  onData: (data) => updateTodosCount(data.length)
+const dispose2 = sharedListsQuery.registerListener({
+  onData: (data) => updatePendingListsCount(data.length)
 });
 ```
 
@@ -421,8 +421,8 @@ Update query parameters to affect all subscribers of the query:
 
 ```javascript
 // Updates to query parameters can be performed in a single place, affecting all subscribers
-watch.updateSettings({
-  query: new GetAllQuery({ sql: `SELECT * FROM todos OFFSET ? LIMIT 100`, parameters: [newOffset] })
+sharedListsQuery.updateSettings({
+  query: { sql: 'SELECT * FROM lists WHERE state = ?', parameters: ['canceled'] }
 });
 ```