Merge branch 'stage'

Author: TizianoT

.github/workflows/search.yml

@@ -13,7 +13,7 @@ jobs:
 
     steps:
       - uses: actions/checkout@v4
-      - uses: sqlitecloud/docsearch-action@v5
+      - uses: sqlitecloud/docsearch-action@v6
         with:
           project-string: ${{ secrets.PROJECT_STRING }}
           base-url: ${{ vars.BASE_URL }}

.gitignore

@@ -0,0 +1 @@
+.DS_Store

sqlite-cloud/_nav.ts

@@ -2,94 +2,56 @@ import type { SidebarNavStruct } from "@docs-website/types/sidebar-navigation";
 
 const sidebarNav: SidebarNavStruct = [
   { title: "", type: "primary" },
-  {
-    title: "Introduction",
-    type: "secondary",
-    icon: "docs-star",
-  },
+  // ### AI ###
+  { title: "AI", type: "secondary", icon: "docs-star",},
+  { title: "Overview", filePath: "ai-overview", type: "inner", level: 0 },
+  { title: "SQLite-AI", filePath: "sqlite-ai", type: "inner", level: 0 },
+  { title: "SQLite-JS", filePath: "sqlite-js", type: "inner", level: 0 },
+  { title: "SQLite-Sync", filePath: "sqlite-sync", type: "inner", level: 0 },
+  { title: "SQLite-Vector", filePath: "sqlite-vector", type: "inner", level: 0 },
+  { title: "MCP (Model Context Protocol)", filePath: "mcp-server", type: "inner", level: 0 },
+
+  // ### CLOUD ###
+  { title: "Cloud", type: "secondary", icon: "docs-star",},
   { title: "Overview", filePath: "overview", type: "inner", level: 0 },
+  { title: "Scaling", filePath: "architecture", type: "inner", level: 0 },
   { title: "Getting Started", type: "inner", level: 0 },
-  { title: "Connecting", filePath: "connect-cluster", type: "inner", level: 1 },
-  {
-    title: "Creating a database",
-    filePath: "create-database",
-    type: "inner",
-    level: 1,
-  },
-  { title: "Writing data", filePath: "write-data", type: "inner", level: 1 },
+      { title: "Connecting", filePath: "connect-cluster", type: "inner", level: 1 },
+      { title: "Creating a database", filePath: "create-database", type: "inner", level: 1 },
+      { title: "Writing data", filePath: "write-data", type: "inner", level: 1 },
   { title: "Quick Start Guides", type: "inner", level: 0 },
-  { title: "CDN", filePath: "quick-start-cdn", type: "inner", level: 1 },
-  { title: "Node.js", filePath: "quick-start-node", type: "inner", level: 1 },
-  { title: "React", filePath: "quick-start-react", type: "inner", level: 1 },
-  {
-    title: "React Native",
-    filePath: "quick-start-react-native",
-    type: "inner",
-    level: 1,
-  },
-  {
-    title: "Apollo / GraphQL",
-    filePath: "quick-start-apollo-graphql",
-    type: "inner",
-    level: 1,
-  },
-  { title: "Next.js", filePath: "quick-start-next", type: "inner", level: 1 },
-  { title: "Django", filePath: "quick-start-django", type: "inner", level: 1 },
-  { title: "Flask", filePath: "quick-start-flask", type: "inner", level: 1 },
-  {
-    title: "SQLAlchemy",
-    filePath: "quick-start-sqlalchemy-orm",
-    type: "inner",
-    level: 1,
-  },
-  {
-    title: "Streamlit",
-    filePath: "quick-start-streamlit",
-    type: "inner",
-    level: 1,
-  },
-  {
-    title: "PHP / Laravel",
-    filePath: "quick-start-php-laravel",
-    type: "inner",
-    level: 1,
-  },
-  { title: "Gin", filePath: "quick-start-gin", type: "inner", level: 1 },
-  { title: "Tutorials", type: "inner", level: 0 },
-  { title: "Geopoly", filePath: "tutorial-geopoly", type: "inner", level: 1 },
-  { title: "Integrations", type: "inner", level: 0 },
-  { title: "Knex.js", filePath: "knex-integration", type: "inner", level: 1 },
+      { title: "CDN", filePath: "quick-start-cdn", type: "inner", level: 1 },
+      { title: "Node.js", filePath: "quick-start-node", type: "inner", level: 1 },
+      { title: "React", filePath: "quick-start-react", type: "inner", level: 1 },
+      { title: "React Native", filePath: "quick-start-react-native", type: "inner", level: 1 },
+      { title: "Apollo / GraphQL", filePath: "quick-start-apollo-graphql", type: "inner", level: 1 },
+      { title: "Next.js", filePath: "quick-start-next", type: "inner", level: 1 },
+      { title: "Django", filePath: "quick-start-django", type: "inner", level: 1 },
+      { title: "Flask", filePath: "quick-start-flask", type: "inner", level: 1 },
+      { title: "SQLAlchemy", filePath: "quick-start-sqlalchemy-orm", type: "inner", level: 1 },
+      { title: "Streamlit", filePath: "quick-start-streamlit", type: "inner", level: 1 },
+      { title: "PHP / Laravel", filePath: "quick-start-php-laravel", type: "inner", level: 1 },
+      { title: "Gin", filePath: "quick-start-gin", type: "inner", level: 1 },
+      { title: "Knex.js", filePath: "quick-start-knex", type: "inner", level: 1 },
 
+  // ### PLATFORM ###
   { title: "Platform", type: "secondary", icon: "docs-plat" },
-  {
-    title: "Edge Functions",
-    filePath: "edge-functions",
-    type: "inner",
-    level: 0,
-  },
-  { title: "Webhooks", filePath: "webhooks", type: "inner", level: 0 },
-  { title: "Pub/Sub", filePath: "pub-sub", type: "inner", level: 0 },
-  { title: "Vector", filePath: "vector", type: "inner", level: 0 },
-  { title: "Scaling", type: "inner", filePath: "architecture", level: 0 },
-  {
-    title: "Security and Access Control",
-    filePath: "security",
-    type: "inner",
-    level: 0,
-  },
-  {
-    title: "Access Tokens",
-    filePath: "access-tokens",
-    type: "inner",
-    level: 0,
-  },
-  { title: "Backups", filePath: "backups", type: "inner", level: 0 },
-  { title: "Query Analyzer", filePath: "analyzer", type: "inner", level: 0 },
-  { title: "Extensions", filePath: "extensions", type: "inner", level: 0 },
-  { title: "Weblite", filePath: "weblite", type: "inner", level: 0 },
-  { title: "AI - Model Context Protocol (MCP)", filePath: "mcp-server", type: "inner", level: 0 },
+      { title: "Edge Functions", filePath: "edge-functions", type: "inner", level: 0 },
+      { title: "Webhooks", filePath: "webhooks", type: "inner", level: 0 },
+      { title: "Pub/Sub", filePath: "pub-sub", type: "inner", level: 0 },
+      //{ title: "Vector", filePath: "vector", type: "inner", level: 0 },
+      { title: "Users and Roles", filePath: "security", type: "inner", level: 0 },
+      { title: "API Keys", filePath: "apikey", type: "inner", level: 0 },
+      { title: "Row-Level Security", filePath: "rls", type: "inner", level: 0},
+      { title: "OffSync", filePath: "offsync", type: "inner", level: 0 },
+      { title: "Access Tokens", filePath: "access-tokens", type: "inner", level: 0 },
+      { title: "Backups", filePath: "backups", type: "inner", level: 0 },
+      { title: "Query Analyzer", filePath: "analyzer", type: "inner", level: 0 },
+      { title: "Extensions", filePath: "extensions", type: "inner", level: 0 },
+      { title: "Weblite (REST API)", filePath: "weblite", type: "inner", level: 0 },
 
-  { title: "SDKs", type: "secondary", icon: "docs-sdk" },
+  // ### CLOUD SDK ###
+  { title: "Cloud SDK", type: "secondary", icon: "docs-sdk" },
   { title: "C/C++", type: "inner", level: 0 },
   {
     title: "Introduction",
@@ -571,6 +533,7 @@ const sidebarNav: SidebarNavStruct = [
     level: 1,
   },
 
+  // ### REFERENCE ###
   { title: "Reference", type: "secondary", icon: "docs-ref" },
   { title: "Server-side Commands", type: "inner", level: 0 },
   {

sqlite-cloud/platform/architecture.mdx renamed to sqlite-cloud/architecture.mdx

@@ -11,6 +11,8 @@ import IndexPage from "@docs-website-components/Docs/IndexPage.astro"
 
 export const introduction = "SQLite Cloud is a distributed relational database system built on top of the SQLite database engine. It has been specifically designed from the ground up to ensure the strong consistency of your data across all nodes in a cluster while simultaneously managing the technical aspects of scaling, security, and data distribution."
 
+
+
 export const sections = [
     {
         icon: "puzzle",

sqlite-cloud/platform/vector.mdx renamed to sqlite-cloud/platform/_vector.mdx

@@ -0,0 +1,20 @@
+---
+title: Security and Access Control
+description: SQLite Cloud provides secure access to resources through role-based authorization, which ensures user isolation and enhances security and manageability.
+category: platform
+status: publish
+slug: apikey
+---
+
+## API KEYs 
+
+API KEYs can be used as an alternative authentication mechanism.
+Authentication through API keys ensures the same privileges as the user to which they are associated.
+API KEYs are recommended for all server-to-server authentication cases and are necessary for using the REST APIs and the SDKs that uses the WebSocket APIs.
+
+To create an API key for a user, click on the **Create API KEY** button.
+
+![Dashboard Create APIKEY](@docs-website-assets/introduction/dashboard_create_apikey.png)
+
+The resulting table will display all the API keys associated with each user, along with their name and restrictions.
+![Dashboard List APIKEY](@docs-website-assets/introduction/dashboard_list_apikey.png)

sqlite-cloud/platform/_wip-index-with-card.mdx

@@ -6,14 +6,17 @@ status: publish
 slug: extensions
 ---
 
-SQLite Cloud comes with the following pre-installed SQLite extensions. These extensions are available for use in your SQLite Cloud databases.
+SQLite Cloud comes with the following pre-installed SQLite extensions.
+These extensions are available for use in your SQLite Cloud databases.
 
 ## Extensions
+- **[SQLite-Vector](sqlite-vector)**: High performance vector storage extension for similarity search.
+- **[SQLite-Sync](sqlite-sync)**:  Local-first extension for true local-first data synchronization for your applications.
+- **[SQLite-JS](sqlite-js)**: Enables JavaScript integration in SQLite for executing server-side logic.
 - **[Full-text Search 5](https://www.sqlite.org/fts5.html)**: Full-text search engine that allows you to search for text in a database.
 - **[JSON1](https://www.sqlite.org/json1.html)**: Allows you to easily store, query, and manipulate JSON data.
 - **[Math](https://www.sqlite.org/lang_mathfunc.html)**: Mathematical functions.
 - **[RTree](https://www.sqlite.org/rtree.html)**: R-Tree index for storing and querying spatial data.
-- **[Geopoly](https://www.sqlite.org/geopoly.html)**: Functions for working with geospatial data.
-- **[sqlite-vec](/docs/vector)**: Vector storage extension for similarity search.
+- **[Geopoly](https://www.sqlite.org/geopoly.html)**: A set of functions for working with geospatial data. For a complete guide, see the [comprehensive tutorial here](tutorial-geopoly).
 
 In the future, we plan to allow users to install their own extensions. If you have a specific extension you would like to use, please let us know by [adding to this issue](https://github.com/sqlitecloud/docs/issues/34).

sqlite-cloud/platform/apikey.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.