chore: add frontmatter

damlayildiz · damlayildiz · commit e8b797f7da23 · 2025-09-30T16:32:12.000+02:00
diff --git a/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_begin_alter.md b/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_begin_alter.md
@@ -1,3 +1,11 @@
+---
+title: SQLite-Sync API Reference - cloudsync_begin_alter
+description: SQLite Sync is a multi-platform extension that brings a true local-first experience to your applications with minimal effort.
+category: platform
+status: publish
+slug: sqlite-sync-api-cloudsync-begin-alter
+---
+
 ### `cloudsync_begin_alter(table_name)`
 
 **Description:** Prepares a synchronized table for schema changes. This function must be called before altering the table. Failure to use `cloudsync_begin_alter` and `cloudsync_commit_alter` can lead to synchronization errors and data divergence.
diff --git a/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_cleanup.md b/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_cleanup.md
@@ -1,3 +1,11 @@
+---
+title: SQLite-Sync API Reference - cloudsync_cleanup
+description: SQLite Sync is a multi-platform extension that brings a true local-first experience to your applications with minimal effort.
+category: platform
+status: publish
+slug: sqlite-sync-api-cloudsync-cleanup
+---
+
 ### `cloudsync_cleanup(table_name)`
 
 **Description:** Removes the `sqlite-sync` synchronization mechanism from a specified table or all tables. This operation drops the associated `_cloudsync` metadata table and removes triggers from the target table(s). Use this function when synchronization is no longer desired for a table.
@@ -14,4 +22,4 @@
 -- Clean up a single table
 SELECT cloudsync_cleanup('my_table');
 
-```
+```
diff --git a/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_commit_alter.md b/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_commit_alter.md
@@ -1,3 +1,11 @@
+---
+title: SQLite-Sync API Reference - cloudsync_commit_alter
+description: SQLite Sync is a multi-platform extension that brings a true local-first experience to your applications with minimal effort.
+category: platform
+status: publish
+slug: sqlite-sync-api-cloudsync-commit-alter
+---
+
 ### `cloudsync_commit_alter(table_name)`
 
 **Description:** Finalizes schema changes for a synchronized table. This function must be called after altering the table's schema, completing the process initiated by `cloudsync_begin_alter` and ensuring CRDT data consistency.
diff --git a/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_db_version.md b/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_db_version.md
@@ -1,3 +1,11 @@
+---
+title: SQLite-Sync API Reference - cloudsync_db_version
+description: SQLite Sync is a multi-platform extension that brings a true local-first experience to your applications with minimal effort.
+category: platform
+status: publish
+slug: sqlite-sync-api-cloudsync-db-version
+---
+
 ### `cloudsync_db_version()`
 
 **Description:** Returns the current database version.
diff --git a/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_disable.md b/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_disable.md
@@ -1,3 +1,11 @@
+---
+title: SQLite-Sync API Reference - cloudsync_disable
+description: SQLite Sync is a multi-platform extension that brings a true local-first experience to your applications with minimal effort.
+category: platform
+status: publish
+slug: sqlite-sync-api-cloudsync-disable
+---
+
 ### `cloudsync_disable(table_name)`
 
 **Description:** Disables synchronization for the specified table.
diff --git a/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_enable.md b/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_enable.md
@@ -1,3 +1,11 @@
+---
+title: SQLite-Sync API Reference - cloudsync_enable
+description: SQLite Sync is a multi-platform extension that brings a true local-first experience to your applications with minimal effort.
+category: platform
+status: publish
+slug: sqlite-sync-api-cloudsync-enable
+---
+
 ### `cloudsync_enable(table_name)`
 
 **Description:** Enables synchronization for the specified table.
diff --git a/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_init.md b/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_init.md
@@ -1,3 +1,11 @@
+---
+title: SQLite-Sync API Reference - cloudsync_init
+description: SQLite Sync is a multi-platform extension that brings a true local-first experience to your applications with minimal effort.
+category: platform
+status: publish
+slug: sqlite-sync-api-cloudsync-init
+---
+
 ### `cloudsync_init(table_name, [crdt_algo], [force])`
 
 **Description:** Initializes a table for `sqlite-sync` synchronization. This function is idempotent and needs to be called only once per table on each site; configurations are stored in the database and automatically loaded with the extension.
@@ -18,7 +26,7 @@ When designing your database schema for SQLite Sync, follow these essential requ
 - **Foreign Key Compatibility**: Be aware of potential conflicts during CRDT merge operations and RLS policy interactions.
 - **Trigger Compatibility**: Triggers may cause duplicate operations or be called multiple times due to column-by-column processing.
 
-For comprehensive guidelines, see the [Database Schema Recommendations](https://github.com/sqliteai/sqlite-sync/blob/main/README.md#database-schema-recommendations) section.
+For comprehensive guidelines, see the [Database Schema Recommendations](/docs/sqlite-sync-best-practices) section.
 
 The function supports three overloads:
 
diff --git a/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_is_enabled.md b/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_is_enabled.md
@@ -1,3 +1,11 @@
+---
+title: SQLite-Sync API Reference - cloudsync_is_enabled
+description: SQLite Sync is a multi-platform extension that brings a true local-first experience to your applications with minimal effort.
+category: platform
+status: publish
+slug: sqlite-sync-api-cloudsync-is-enabled
+---
+
 ### `cloudsync_is_enabled(table_name)`
 
 **Description:** Checks if synchronization is enabled for the specified table.
diff --git a/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_network_check_changes.md b/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_network_check_changes.md
@@ -1,11 +1,19 @@
+---
+title: SQLite-Sync API Reference - cloudsync_network_check_changes
+description: SQLite Sync is a multi-platform extension that brings a true local-first experience to your applications with minimal effort.
+category: platform
+status: publish
+slug: sqlite-sync-api-cloudsync-network-check-changes
+---
+
 ### `cloudsync_network_check_changes()`
 
 **Description:** Checks the remote server for new changes and applies them to the local database.
 
 If a package of new changes is already available for the local site, the server returns it immediately, and the changes are applied. If no package is ready, the server returns an empty response and starts an asynchronous process to prepare a new package. This new package can be retrieved with a subsequent call to this function.
 
 This function is designed to be called periodically to keep the local database in sync.
-To force an update and wait for changes (with a timeout), use [`cloudsync_network_sync(wait_ms, max_retries)`].
+To force an update and wait for changes (with a timeout), use `cloudsync_network_sync(wait_ms, max_retries)`.
 
 If the network is misconfigured or the remote server is unreachable, the function returns an error.
 On success, it returns `SQLITE_OK`, and the return value indicates how many changes were downloaded and applied.
diff --git a/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_network_cleanup.md b/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_network_cleanup.md
@@ -1,3 +1,11 @@
+---
+title: SQLite-Sync API Reference - cloudsync_network_cleanup
+description: SQLite Sync is a multi-platform extension that brings a true local-first experience to your applications with minimal effort.
+category: platform
+status: publish
+slug: sqlite-sync-api-cloudsync-network-cleanup
+---
+
 ### `cloudsync_network_cleanup()`
 
 **Description:** Cleans up the `sqlite-sync` network component, releasing all resources allocated by `cloudsync_network_init` (memory, cURL handles).
diff --git a/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_network_has_unsent_changes.md b/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_network_has_unsent_changes.md
@@ -1,3 +1,11 @@
+---
+title: SQLite-Sync API Reference - cloudsync_network_has_unsent_changes
+description: SQLite Sync is a multi-platform extension that brings a true local-first experience to your applications with minimal effort.
+category: platform
+status: publish
+slug: sqlite-sync-api-cloudsync-network-has-unsent-changes
+---
+
 ### `cloudsync_network_has_unsent_changes()`
 
 **Description:** Checks if there are any local changes that have not yet been sent to the remote server.
diff --git a/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_network_init.md b/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_network_init.md
@@ -1,3 +1,11 @@
+---
+title: SQLite-Sync API Reference - cloudsync_network_init
+description: SQLite Sync is a multi-platform extension that brings a true local-first experience to your applications with minimal effort.
+category: platform
+status: publish
+slug: sqlite-sync-api-cloudsync-network-init
+---
+
 ### `cloudsync_network_init(connection_string)`
 
 **Description:** Initializes the `sqlite-sync` network component. This function parses the connection string to configure change checking and upload endpoints, and initializes the cURL library.
diff --git a/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_network_logout.md b/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_network_logout.md
@@ -1,3 +1,11 @@
+---
+title: SQLite-Sync API Reference - cloudsync_network_logout
+description: SQLite Sync is a multi-platform extension that brings a true local-first experience to your applications with minimal effort.
+category: platform
+status: publish
+slug: sqlite-sync-api-cloudsync-network-logout
+---
+
 ### `cloudsync_network_logout()`
 
 **Description:** Logs out the current user and cleans up all local data from synchronized tables. This function deletes and then re-initializes synchronized tables, useful for switching users or resetting the local database. **Warning:** This function deletes all data from synchronized tables. Use with caution.
diff --git a/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_network_reset_sync_version.md b/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_network_reset_sync_version.md
@@ -1,3 +1,11 @@
+---
+title: SQLite-Sync API Reference - cloudsync_network_reset_sync_version
+description: SQLite Sync is a multi-platform extension that brings a true local-first experience to your applications with minimal effort.
+category: platform
+status: publish
+slug: sqlite-sync-api-cloudsync-network-reset-sync-version
+---
+
 ### `cloudsync_network_reset_sync_version()`
 
 **Description:** Resets local synchronization version numbers, forcing the next sync to fetch all changes from the server.
diff --git a/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_network_send_changes.md b/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_network_send_changes.md
@@ -1,3 +1,11 @@
+---
+title: SQLite-Sync API Reference - cloudsync_network_send_changes
+description: SQLite Sync is a multi-platform extension that brings a true local-first experience to your applications with minimal effort.
+category: platform
+status: publish
+slug: sqlite-sync-api-cloudsync-network-send-changes
+---
+
 ### `cloudsync_network_send_changes()`
 
 **Description:** Sends all unsent local changes to the remote server.
@@ -6,8 +14,6 @@
 
 **Returns:** None.
 
-**Errors:** See [Network Errors](#network-errors) for common error conditions.
-
 **Example:**
 
 ```sql
diff --git a/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_network_set_apikey.md b/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_network_set_apikey.md
@@ -1,3 +1,11 @@
+---
+title: SQLite-Sync API Reference - cloudsync_network_set_apikey
+description: SQLite Sync is a multi-platform extension that brings a true local-first experience to your applications with minimal effort.
+category: platform
+status: publish
+slug: sqlite-sync-api-cloudsync-network-set-apikey
+---
+
 ### `cloudsync_network_set_apikey(apikey)`
 
 **Description:** Sets the API key for network requests. This key is included in the `Authorization` header of all subsequent requests.
diff --git a/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_network_set_token.md b/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_network_set_token.md
@@ -1,6 +1,14 @@
+---
+title: SQLite-Sync API Reference - cloudsync_network_set_token
+description: SQLite Sync is a multi-platform extension that brings a true local-first experience to your applications with minimal effort.
+category: platform
+status: publish
+slug: sqlite-sync-api-cloudsync-network-set-token
+---
+
 ### `cloudsync_network_set_token(token)`
 
-**Description:** Sets the authentication token to be used for network requests. This token will be included in the `Authorization` header of all subsequent requests. For more information, refer to the [Access Tokens documentation](https://docs.sqlitecloud.io/docs/access-tokens).
+**Description:** Sets the authentication token to be used for network requests. This token will be included in the `Authorization` header of all subsequent requests. For more information, refer to the [Access Tokens documentation](/docs/access-tokens).
 
 **Parameters:**
 
diff --git a/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_network_sync.md b/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_network_sync.md
@@ -1,3 +1,11 @@
+---
+title: SQLite-Sync API Reference - cloudsync_network_sync
+description: SQLite Sync is a multi-platform extension that brings a true local-first experience to your applications with minimal effort.
+category: platform
+status: publish
+slug: sqlite-sync-api-cloudsync-network-sync
+---
+
 ### `cloudsync_network_sync([wait_ms], [max_retries])`
 
 **Description:** Performs a full synchronization cycle. This function has two overloads:
@@ -12,8 +20,6 @@
 
 **Returns:** The number of changes downloaded. Errors are reported via the SQLite return code.
 
-**Errors:** See [Network Errors](#network-errors) for common error conditions.
-
 **Example:**
 
 ```sql
diff --git a/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_siteid.md b/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_siteid.md
@@ -1,3 +1,11 @@
+---
+title: SQLite-Sync API Reference - cloudsync_siteid
+description: SQLite Sync is a multi-platform extension that brings a true local-first experience to your applications with minimal effort.
+category: platform
+status: publish
+slug: sqlite-sync-api-cloudsync-siteid
+---
+
 ### `cloudsync_siteid()`
 
 **Description:** Returns the unique ID of the local site.
diff --git a/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_terminate.md b/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_terminate.md
@@ -1,3 +1,11 @@
+---
+title: SQLite-Sync API Reference - cloudsync_terminate
+description: SQLite Sync is a multi-platform extension that brings a true local-first experience to your applications with minimal effort.
+category: platform
+status: publish
+slug: sqlite-sync-api-cloudsync-terminate
+---
+
 ### `cloudsync_terminate()`
 
 **Description:** Releases all internal resources used by the `sqlite-sync` extension for the current database connection. This function should be called before closing the database connection to ensure that all prepared statements and allocated memory are freed. Failing to call this function can result in memory leaks or a failed `sqlite3_close` operation due to pending statements.
diff --git a/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_uuid.md b/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_uuid.md
@@ -1,3 +1,11 @@
+---
+title: SQLite-Sync API Reference - cloudsync_uuid
+description: SQLite Sync is a multi-platform extension that brings a true local-first experience to your applications with minimal effort.
+category: platform
+status: publish
+slug: sqlite-sync-api-cloudsync-uuid
+---
+
 ### `cloudsync_uuid()`
 
 **Description:** Generates a new universally unique identifier (UUIDv7). This is useful for creating globally unique primary keys for new records, which is a best practice for CRDTs.
diff --git a/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_version.md b/sqlite-cloud/sqlite-ai/sqlite-sync/api-reference/cloudsync_version.md
@@ -1,3 +1,11 @@
+---
+title: SQLite-Sync API Reference - cloudsync_version
+description: SQLite Sync is a multi-platform extension that brings a true local-first experience to your applications with minimal effort.
+category: platform
+status: publish
+slug: sqlite-sync-api-cloudsync-version
+---
+
 ### `cloudsync_version()`
 
 **Description:** Returns the version of the `sqlite-sync` library.
diff --git a/sqlite-cloud/sqlite-ai/sqlite-sync/best-practices.md b/sqlite-cloud/sqlite-ai/sqlite-sync/best-practices.md
@@ -1,3 +1,11 @@
+---
+title: SQLite-Sync Best Practices
+description: SQLite Sync is a multi-platform extension that brings a true local-first experience to your applications with minimal effort.
+category: platform
+status: publish
+slug: sqlite-sync-best-practices
+---
+
 ## Database Schema Recommendations
 
 When designing your database schema for SQLite Sync, follow these best practices to ensure optimal CRDT performance and conflict resolution:
@@ -64,7 +72,7 @@ CREATE TABLE users (
 
 ### Foreign Key Compatibility
 
-When using foreign key constraints with SQLite Sync, be aware that interactions with the CRDT merge algorithm and Row-Level Security policies may cause constraint violations. 
+When using foreign key constraints with SQLite Sync, be aware that interactions with the CRDT merge algorithm and Row-Level Security policies may cause constraint violations.
 
 #### Potential Conflicts
 
@@ -75,18 +83,21 @@ When using foreign key constraints with SQLite Sync, be aware that interactions
 - If a foreign key column has a DEFAULT value, that value must exist in the referenced table
 
 **Row-Level Security and CASCADE Actions**
+
 - RLS policies may block operations required for maintaining referential integrity
 - CASCADE DELETE/UPDATE operations may fail if RLS prevents access to related rows
 
 #### Recommendations
 
 **Database Design Patterns**
+
 - Prefer application-level cascade logic over database-level CASCADE actions
 - Design RLS policies to accommodate referential integrity operations
 - Use nullable foreign keys where appropriate to avoid DEFAULT value issues
 - Alternatively, ensure DEFAULT values for foreign key columns exist in their referenced tables
 
 **Testing and Validation**
+
 - Test synchronization scenarios with foreign key constraints enabled
 - Monitor for constraint violations during sync operations in development
 
@@ -95,10 +106,12 @@ When using foreign key constraints with SQLite Sync, be aware that interactions
 Be aware that certain types of triggers can cause errors during synchronization due to SQLite Sync's merge logic.
 
 **Duplicate Operations**
+
 - If a trigger modifies a table that is also synchronized with SQLite Sync, changes performed by the trigger may be applied twice during the merge operation
 - This can lead to constraint violations or unexpected data states depending on the table's constraints
 
 **Column-by-Column Processing**
+
 - SQLite Sync applies changes column-by-column during synchronization
 - UPDATE triggers may be called multiple times for a single row as each column is processed
-- This can result in unexpected trigger behavior
+- This can result in unexpected trigger behavior
diff --git a/sqlite-cloud/sqlite-ai/sqlite-sync/getting-started.md b/sqlite-cloud/sqlite-ai/sqlite-sync/getting-started.md
@@ -1,3 +1,11 @@
+---
+title: SQLite-Sync Getting Started
+description: SQLite Sync is a multi-platform extension that brings a true local-first experience to your applications with minimal effort.
+category: platform
+status: publish
+slug: sqlite-sync-getting-started
+---
+
 # Getting Started
 
 Here's a quick example to get started with SQLite Sync:
@@ -12,7 +20,7 @@ Here's a quick example to get started with SQLite Sync:
 1. Create a new project and database in your [SQLite Cloud Dashboard](https://dashboard.sqlitecloud.io/)
 2. Copy your connection string and API key from the dashboard
 3. Create tables with identical schema in both local and cloud databases
-4. [Enable synchronization](https://docs.sqlitecloud.io/docs/offsync#:~:text=in%20the%20cloud.-,Configuring%20OffSync,-You%20can%20enable): go to Databases > Offsync page and select each table you want to synchronize in your database
+4. [Enable synchronization](/docs/offsync#:~:text=in%20the%20cloud.-,Configuring%20OffSync,-You%20can%20enable): go to Databases > Offsync page and select each table you want to synchronize in your database
 
 ### Local Database Setup
 
diff --git a/sqlite-cloud/sqlite-ai/sqlite-sync/introduction.md b/sqlite-cloud/sqlite-ai/sqlite-sync/introduction.md
diff --git a/sqlite-cloud/sqlite-ai/sqlite-sync/quick-starts/android.md b/sqlite-cloud/sqlite-ai/sqlite-sync/quick-starts/android.md
diff --git a/sqlite-cloud/sqlite-ai/sqlite-sync/quick-starts/ios.md b/sqlite-cloud/sqlite-ai/sqlite-sync/quick-starts/ios.md
diff --git a/sqlite-cloud/sqlite-ai/sqlite-sync/quick-starts/linux.md b/sqlite-cloud/sqlite-ai/sqlite-sync/quick-starts/linux.md
diff --git a/sqlite-cloud/sqlite-ai/sqlite-sync/quick-starts/macos.md b/sqlite-cloud/sqlite-ai/sqlite-sync/quick-starts/macos.md
diff --git a/sqlite-cloud/sqlite-ai/sqlite-sync/quick-starts/react-native-expo.md b/sqlite-cloud/sqlite-ai/sqlite-sync/quick-starts/react-native-expo.md
diff --git a/sqlite-cloud/sqlite-ai/sqlite-sync/quick-starts/wasm.md b/sqlite-cloud/sqlite-ai/sqlite-sync/quick-starts/wasm.md
diff --git a/sqlite-cloud/sqlite-ai/sqlite-sync/quick-starts/windows.md b/sqlite-cloud/sqlite-ai/sqlite-sync/quick-starts/windows.md
