diff --git a/client-sdks/reference/capacitor.mdx b/client-sdks/reference/capacitor.mdx
index a018efdd..66b4a756 100644
--- a/client-sdks/reference/capacitor.mdx
+++ b/client-sdks/reference/capacitor.mdx
@@ -4,6 +4,7 @@ description: "Use PowerSync in Capacitor apps."
sidebarTitle: "SDK Reference"
---
+import AiQuickstart from '/snippets/ai-quickstart.mdx';
import SdkFeatures from '/snippets/sdk-features.mdx';
import CapacitorInstallation from '/snippets/capacitor/installation.mdx';
import JavaScriptAsyncWatch from '/snippets/basic-watch-query-javascript-async.mdx';
@@ -51,6 +52,14 @@ import LocalOnly from '/snippets/local-only-escape.mdx';
+## AI Quickstart
+
+
+
## Installation
diff --git a/client-sdks/reference/dotnet.mdx b/client-sdks/reference/dotnet.mdx
index 7d66c7ce..85aa4f7d 100644
--- a/client-sdks/reference/dotnet.mdx
+++ b/client-sdks/reference/dotnet.mdx
@@ -4,6 +4,7 @@ description: "Use PowerSync in .NET apps (beta)."
sidebarTitle: "SDK Reference"
---
+import AiQuickstart from '/snippets/ai-quickstart.mdx';
import SdkFeatures from '/snippets/sdk-features.mdx';
import DotNetInstallation from '/snippets/dotnet/installation.mdx';
import DotNetWatch from '/snippets/dotnet/basic-watch-query.mdx';
@@ -56,6 +57,14 @@ For more details, please refer to the package [README](https://github.com/powers
+## AI Quickstart
+
+
+
## Quickstart
diff --git a/client-sdks/reference/flutter.mdx b/client-sdks/reference/flutter.mdx
index 89d8e2fa..bdde2f60 100644
--- a/client-sdks/reference/flutter.mdx
+++ b/client-sdks/reference/flutter.mdx
@@ -4,6 +4,7 @@ description: "Use PowerSync in Dart and Flutter apps."
sidebarTitle: "SDK Reference"
---
+import AiQuickstart from '/snippets/ai-quickstart.mdx';
import SdkFeatures from '/snippets/sdk-features.mdx';
import FlutterInstallation from '/snippets/flutter/installation.mdx';
import FlutterWatch from '/snippets/flutter/basic-watch-query.mdx';
@@ -43,6 +44,14 @@ Get started quickly by using the self-hosted **Flutter** + **Supabase** template
Web support is currently in a beta release. Refer to [Flutter Web Support](/client-sdks/frameworks/flutter-web-support) for more details.
+## AI Quickstart
+
+
+
## Installation
diff --git a/client-sdks/reference/javascript-web.mdx b/client-sdks/reference/javascript-web.mdx
index c816ba77..b011f529 100644
--- a/client-sdks/reference/javascript-web.mdx
+++ b/client-sdks/reference/javascript-web.mdx
@@ -4,6 +4,7 @@ description: "Use PowerSync in JavaScript Web apps."
sidebarTitle: "SDK Reference"
---
+import AiQuickstart from '/snippets/ai-quickstart.mdx';
import SdkFeatures from '/snippets/sdk-features.mdx';
import JavaScriptWebInstallation from '/snippets/javascript-web/installation.mdx';
import JavaScriptAsyncWatch from '/snippets/basic-watch-query-javascript-async.mdx';
@@ -80,6 +81,14 @@ The PowerSync [JavaScript Web SDK](../javascript-web) is compatible with popular
+## AI Quickstart
+
+
+
## Installation
diff --git a/client-sdks/reference/kotlin.mdx b/client-sdks/reference/kotlin.mdx
index a89a8d71..e94f800d 100644
--- a/client-sdks/reference/kotlin.mdx
+++ b/client-sdks/reference/kotlin.mdx
@@ -4,6 +4,7 @@ description: "Use PowerSync in Kotlin Multiplatform apps."
sidebarTitle: "SDK Reference"
---
+import AiQuickstart from '/snippets/ai-quickstart.mdx';
import SdkFeatures from '/snippets/sdk-features.mdx';
import KotlinInstallation from '/snippets/kotlin/installation.mdx';
import KotlinWatch from '/snippets/kotlin/basic-watch-query.mdx';
@@ -32,6 +33,14 @@ import LocalOnly from '/snippets/local-only-escape.mdx';
+## AI Quickstart
+
+
+
## Installation
diff --git a/client-sdks/reference/node.mdx b/client-sdks/reference/node.mdx
index 05c2051d..99d84378 100644
--- a/client-sdks/reference/node.mdx
+++ b/client-sdks/reference/node.mdx
@@ -4,6 +4,7 @@ description: "Use PowerSync in Node.js apps."
sidebarTitle: "SDK Reference"
---
+import AiQuickstart from '/snippets/ai-quickstart.mdx';
import SdkFeatures from '/snippets/sdk-features.mdx';
import NodeInstallation from '/snippets/node/installation.mdx';
import JavaScriptAsyncWatch from '/snippets/basic-watch-query-javascript-async.mdx';
@@ -44,6 +45,14 @@ import LocalOnly from '/snippets/local-only-escape.mdx';
+## AI Quickstart
+
+
+
## Quickstart
diff --git a/client-sdks/reference/react-native-and-expo.mdx b/client-sdks/reference/react-native-and-expo.mdx
index fa30a46c..416f0500 100644
--- a/client-sdks/reference/react-native-and-expo.mdx
+++ b/client-sdks/reference/react-native-and-expo.mdx
@@ -4,6 +4,7 @@ description: "Use PowerSync in React Native (& Expo) apps."
sidebarTitle: "SDK Reference"
---
+import AiQuickstart from '/snippets/ai-quickstart.mdx';
import SdkFeatures from '/snippets/sdk-features.mdx';
import ReactNativeInstallation from '/snippets/react-native/installation.mdx';
import JavaScriptAsyncWatch from '/snippets/basic-watch-query-javascript-async.mdx';
@@ -45,6 +46,14 @@ A separate `powersync-react` package is available containing React hooks for Pow
/>
+## AI Quickstart
+
+
+
## Installation
diff --git a/client-sdks/reference/rust.mdx b/client-sdks/reference/rust.mdx
index ae43c229..dd9908af 100644
--- a/client-sdks/reference/rust.mdx
+++ b/client-sdks/reference/rust.mdx
@@ -4,6 +4,7 @@ description: "Use PowerSync in Rust apps."
sidebarTitle: "SDK Reference"
---
+import AiQuickstart from '/snippets/ai-quickstart.mdx';
import SdkFeatures from '/snippets/sdk-features.mdx';
import RustInstallation from '/snippets/rust/installation.mdx';
import RustWatchQuery from '/snippets/rust/basic-watch-query.mdx';
@@ -36,6 +37,14 @@ import LocalOnly from '/snippets/local-only-escape.mdx';
+## AI Quickstart
+
+
+
## Installation
diff --git a/client-sdks/reference/swift.mdx b/client-sdks/reference/swift.mdx
index 4460f845..e1d7a77d 100644
--- a/client-sdks/reference/swift.mdx
+++ b/client-sdks/reference/swift.mdx
@@ -4,6 +4,7 @@ description: "Use PowerSync in Swift apps."
sidebarTitle: "SDK Reference"
---
+import AiQuickstart from '/snippets/ai-quickstart.mdx';
import SdkFeatures from '/snippets/sdk-features.mdx';
import SwiftInstallation from '/snippets/swift/installation.mdx';
import SwiftWatch from '/snippets/swift/basic-watch-query.mdx';
@@ -34,6 +35,14 @@ import LocalOnly from '/snippets/local-only-escape.mdx';
### SDK Features
+## AI Quickstart
+
+
+
## Installation
diff --git a/client-sdks/reference/tauri.mdx b/client-sdks/reference/tauri.mdx
index bfe17681..f9316abc 100644
--- a/client-sdks/reference/tauri.mdx
+++ b/client-sdks/reference/tauri.mdx
@@ -4,7 +4,7 @@ description: "Use PowerSync in Tauri apps."
sidebarTitle: "SDK Reference"
---
-
+import AiQuickstart from '/snippets/ai-quickstart.mdx';
import SdkFeatures from '/snippets/sdk-features.mdx';
import TauriInstallation from '/snippets/tauri/installation.mdx';
import JavaScriptAsyncWatch from '/snippets/basic-watch-query-javascript-async.mdx';
@@ -43,6 +43,14 @@ import MutationConfirmationWithReturning from '/snippets/javascript-mutation-con
+## AI Quickstart
+
+
+
## Installation
diff --git a/intro/powersync-overview.mdx b/intro/powersync-overview.mdx
index 1a5426f5..5dc54241 100644
--- a/intro/powersync-overview.mdx
+++ b/intro/powersync-overview.mdx
@@ -22,10 +22,46 @@ PowerSync is made up of the PowerSync Service and a set of client SDKs. The Powe
The architecture and the philosophy behind PowerSync.
- Official PowerSync skills for Claude Code, Convex, and other AI-powered coding tools.
+ Official PowerSync skills for Claude Code, Codex, and other AI-powered coding tools.
+## AI Quickstart
+
+
+```text
+Add PowerSync to this project so the app reads and writes a local SQLite
+database that syncs with my backend database.
+
+Install the PowerSync Agent Skills in this project and follow them:
+
+ npx skills add powersync-ja/agent-skills
+
+Inspect the project to identify my language and framework, then confirm the
+matching PowerSync client SDK with me. PowerSync has SDKs for Flutter,
+React Native & Expo, JavaScript Web, Capacitor, Node.js, Tauri, Kotlin
+Multiplatform, Swift, .NET, and Rust. Use
+https://docs.powersync.com/client-sdks/overview.md to find the SDK
+reference, and check the PowerSync docs when something is unclear rather
+than guessing. Do not invent APIs.
+
+Ask me these questions and wait for my answers before writing code:
+
+1. Which backend database am I syncing from: Postgres, MongoDB, MySQL, or
+ SQL Server? Am I on a hosted platform such as Supabase?
+2. Do I have a PowerSync Service instance (PowerSync Cloud or self-hosted)?
+ If not, help me set one up first.
+3. Which tables does my app need locally, and which rows should each user
+ receive?
+4. How do users authenticate?
+
+Then work step by step: define the client-side schema, write Sync Stream
+definitions for the data I described and show me how to apply them on the
+PowerSync Service, instantiate the PowerSync database, implement a backend
+connector, and connect. Verify the app builds and syncs before you finish.
+```
+
+
## Supported Backend Source Databases
PowerSync is designed to be backend database agnostic, and supports these source databases:
diff --git a/snippets/ai-quickstart.mdx b/snippets/ai-quickstart.mdx
new file mode 100644
index 00000000..c648341a
--- /dev/null
+++ b/snippets/ai-quickstart.mdx
@@ -0,0 +1,29 @@
+export const AiQuickstart = ({ sdk, slug, question }) => <>>;
+
+
+Set up PowerSync in this project using the PowerSync {sdk} SDK.
+
+Install the PowerSync Agent Skills in this project and follow them:
+
+ npx skills add powersync-ja/agent-skills
+
+Use https://docs.powersync.com/{slug}.md as the SDK reference. When
+something is unclear, check the PowerSync docs or ask me. Do not invent
+APIs.
+
+Ask me these questions and wait for my answers before writing code:
+
+1. Which backend database am I syncing from: Postgres, MongoDB, MySQL, or
+ SQL Server? Am I on a hosted platform such as Supabase?
+2. Do I have a PowerSync Service instance (PowerSync Cloud or self-hosted)?
+ If not, help me set one up first.
+3. Which tables does my app need locally, and which rows should each user
+ receive?
+4. How do users authenticate?
+5. {question}
+
+Then work step by step: define the client-side schema, write Sync Stream
+definitions for the data I described and show me how to apply them on the
+PowerSync Service, instantiate the PowerSync database, implement a backend
+connector, and connect. Verify the app builds and syncs before you finish.
+
diff --git a/tools/ai-tools.mdx b/tools/ai-tools.mdx
index 15bb9407..63d67e4a 100644
--- a/tools/ai-tools.mdx
+++ b/tools/ai-tools.mdx
@@ -21,6 +21,10 @@ Learn more:
PowerSync Agent Skills repository
+## Copyable Prompts
+
+Each [client SDK reference](/client-sdks/overview) includes an AI Quickstart section with a prompt you can copy straight into your coding agent, or open in Cursor. The prompts install the Agent Skills in your project and have the agent ask about your backend database, PowerSync Service instance, data scoping, and authentication before it writes code. The [documentation home page](/intro/powersync-overview#ai-quickstart) has a version for projects where you haven't picked an SDK yet.
+
## AI-Accessible Documentation
### Markdown Documentation