Merge pull request #119 from sqlitecloud/feat/add-offsync-doc

add offsync doc

Author: andinux

sqlite-cloud/_nav.ts

@@ -83,6 +83,7 @@ const sidebarNav: SidebarNavStruct = [
     type: "inner",
     level: 0,
   },
+  { title: "Offsync", filePath: "offsync", type: "inner", level: 0 },
   {
     title: "Access Tokens",
     filePath: "access-tokens",

sqlite-cloud/platform/offsync.mdx

@@ -0,0 +1,42 @@
+---
+title: Offsync
+description: Enable local-first applications with automatic data synchronization between edge devices and SQLite Cloud.
+category: platform
+status: publish
+slug: offsync
+---
+
+import Callout from "@commons-components/Information/Callout.astro";
+
+Offsync is a powerful SQLite Cloud feature that enables true **local-first** data synchronization for your applications. Powered by the [SQLite Sync](https://github.com/sqliteai/sqlite-sync) extension, it allows you to build robust, offline-capable applications where data is stored and processed on edge devices and seamlessly synchronized with a central SQLite Cloud database.
+
+This architecture is ideal for mobile apps, IoT devices, and any application requiring high availability and low latency, even with intermittent network connectivity. By leveraging Conflict-free Replicated Data Types (CRDTs), Offsync ensures that changes made offline are merged automatically and without conflicts when the device reconnects.
+
+## How It Works
+
+Offsync extends standard SQLite tables with built-in support for offline work and automatic synchronization. This allows multiple devices to operate independently and then seamlessly merge their changes.
+
+- **Offline-First by Design**: Applications work seamlessly even when devices are offline. Changes are queued locally and synced automatically when connectivity is restored.
+- **CRDT-Based Conflict Resolution**: Merges updates deterministically and efficiently, ensuring eventual consistency across all replicas without complex merge logic.
+- **Seamless Integration**: The sync layer is tightly integrated with SQLite Cloud, enabling secure data sharing across devices, users, and platforms.
+
+When combined with [Row-Level Security (RLS)](/docs/rls), Offsync allows you to build secure, multi-tenant applications where each user's data is safely isolated, both on the edge and in the cloud.
+
+## Configuring Offsync
+
+You can enable and manage Offsync for your databases directly from the SQLite Cloud dashboard.
+
+1.  **Navigate to the Databases Page**: From the main dashboard, go to the "Databases" page.
+2.  **Select the Offsync Column**: In the list of your databases, click on the button in the "Offsync" column for the desired database.
+
+    ![Dashboard Databases Page](@docs-website-assets/introduction/offsync-1.png)
+
+3.  **Enable Tables for Synchronization**: On the Offsync settings page, you will see a list of all tables in your database. Toggle the switch next to each table you want to enable for synchronization.
+
+    ![Dashboard Offsync Settings Page](@docs-website-assets/introduction/offsync-2.png)
+
+<Callout type="note" title="Matching Schemas and Tables">
+For Offsync to work correctly, the list of tables configured for synchronization—and their corresponding schemas—must be identical in both your local SQLite database and your SQLite Cloud database.
+</Callout>
+
+Once enabled, any changes made to the selected tables via the SQLite Sync extension will be automatically synchronized with your SQLite Cloud database.

sqlite-cloud/platform/rls.mdx

@@ -16,7 +16,7 @@ RLS rules only affect users who are authenticated using [Access Tokens](/docs/ac
 
 RLS is a powerful feature for building secure, multi-tenant applications. When combined with [SQLite Sync](https://github.com/sqliteai/sqlite-sync), it enables you to create robust **local-first apps** where user data is stored on the device for offline availability and superior performance.
 
-This architecture simplifies development by allowing your application to interact with a local database while SQLite Cloud transparently handles the synchronization with a central database. RLS ensures that each user's data is securely isolated during this process. The centralized database can then be used for powerful business analytics and reporting across all tenants, without compromising individual data privacy.
+This architecture simplifies development by allowing your application to interact with a local database while SQLite Cloud [OffSync](/docs/offsync) transparently handles the synchronization with a central database. RLS ensures that each user's data is securely isolated during this process. The centralized database can then be used for powerful business analytics and reporting across all tenants, without compromising individual data privacy.
 
 ## Policy Enforcement