Updated documentation

Author: marcobambini

.gitignore

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

sqlite-cloud/_nav.ts

@@ -2,101 +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: "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", 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",
@@ -578,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

@@ -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/vector.mdx renamed to sqlite-cloud/platform/_vector.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

@@ -148,7 +148,7 @@ A role can contains any combination of privileges.
 -----------------|
 ```
 
-
+{/*
 ## IP Restrictions
 The IP Restrictions panel enables the restriction of access for a role or user by allowing only specific IP addresses or ranges in [CIDR notation](https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) (for example 10.10.10.0/24). Both IPv4 and IPv6 addresses are supported.
 
@@ -159,14 +159,4 @@ To add a new IP restriction to a user or role, click on the **Add IP** button.
 The IP Restrictions table will display all current IP restrictions for the selected user or role.
 
 ![Dashboard List IP Restrictions](@docs-website-assets/introduction/dashboard_list_ip.png)
-
-## 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)
+*/}