feat: Add sync-docs script and update deployment workflow

Author: nexckycort

.github/workflows/docs-deploy.yml

@@ -16,6 +16,8 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - uses: oven-sh/setup-bun@v2
+      - name: Sync docs content
+        run: bun run sync-docs
       - name: Install dependencies
         run: bun install
       - name: Build

README.md

@@ -1,10 +1,17 @@
-# Bloque SDK Documentation
+# Bloque Documentation
 
-Official documentation for the Bloque SDK.
+Official documentation for Bloque - Financial Infrastructure for Developers.
 
 ## Overview
 
-This documentation covers the **@bloque/sdk** - a TypeScript/JavaScript SDK for integrating Bloque services into your applications.
+This documentation covers the **Bloque Stack** - a unified financial infrastructure platform with comprehensive tools for payments, accounts, cards, and identity verification.
+
+### Bloque Stack
+
+- **Bloque SDK**: Create organizations, verify identities, issue cards, and manage accounts with a single SDK
+- **Bloque Payment**: Complete payment gateway to process transactions securely and efficiently
+
+### Bloque SDK Modules
 
 The SDK provides modules for:
 
@@ -39,6 +46,8 @@ bun run dev
 
 The documentation will be available at `http://localhost:5173`
 
+> **Note:** The SDK reference documentation is automatically downloaded and generated at runtime when you start the dev server. This ensures you always have the latest API documentation.
+
 Build the website for production:
 
 ```bash
@@ -56,48 +65,63 @@ bun run preview
 ```
 docs/
 ├── en/                     # English documentation
-│   ├── guide/             # Getting started guide
-│   │   ├── start/         # Quick start
-│   │   ├── features/      # SDK features
-│   │   ├── accounts/      # Account management
-│   │   └── examples/      # Code examples
-│   └── index.md           # Home page
+│   ├── index.md           # Bloque Stack home page
+│   ├── sdk/               # Bloque SDK documentation
+│   │   ├── index.md       # SDK home page
+│   │   ├── .generated     # Auto-generated API reference (runtime)
+│   │   └── guide/         # SDK guides (manual)
+│   │       ├── start/     # Quick start
+│   │       ├── features/  # SDK features
+│   │       ├── accounts/  # Account management
+│   │       └── examples/  # Code examples
+│   └── payment/           # Bloque Payment documentation (coming soon)
 └── es/                     # Spanish documentation
-    ├── guide/             # Guía de inicio
-    │   ├── start/         # Inicio rápido
-    │   ├── features/      # Características del SDK
-    │   ├── accounts/      # Gestión de cuentas
-    │   └── examples/      # Ejemplos de código
-    └── index.md           # Página de inicio
+    ├── index.md           # Página principal de Bloque Stack
+    ├── sdk/               # Documentación de Bloque SDK
+    │   ├── index.md       # Página principal del SDK
+    │   ├── .generated     # Referencia API auto-generada (runtime)
+    │   └── guide/         # Guías del SDK (manual)
+    │       ├── start/     # Inicio rápido
+    │       ├── features/  # Características del SDK
+    │       ├── accounts/  # Gestión de cuentas
+    │       └── examples/  # Ejemplos de código
+    └── payment/           # Documentación de Bloque Payment (próximamente)
 ```
 
+> **Note:** Files marked with `.generated` are automatically downloaded and generated at runtime from the SDK source code. Do not edit these files manually as they will be overwritten.
+
 ## Content
 
-### Getting Started
+### Bloque Stack Overview
+- Introduction to Bloque ecosystem
+- Available products and tools
+- Integration guides
+
+### Bloque SDK
+
+#### Manual Documentation
 - Installation guide
 - Quick start examples
 - Platform support (Node.js, Bun, Deno, Browser)
 - User sessions and authentication
+- Code examples and tutorials
+- Integration guides
 
-### Features
-- Organizations management
-- Compliance (KYC/KYB)
-- Account management
-- Virtual cards
-- Identity registration
-- User sessions
-
-### Examples
-- Backend integration examples
-- Virtual card creation
-- User registration flows
-- Session management
+#### Auto-generated API Reference (Runtime)
+The complete API reference is automatically generated from TypeScript source code:
+- Organizations API (`@bloque/sdk-orgs`)
+- Compliance API (`@bloque/sdk-compliance`)
+- Accounts API (`@bloque/sdk-accounts`)
+- Identity API (`@bloque/sdk-identity`)
+- Core utilities (`@bloque/sdk-core`)
 
-## Technology
+This ensures the documentation is always in sync with the latest SDK version.
 
-Built with [Rspress](https://rspress.dev/) - Fast Rspack-based documentation framework
+### Bloque Payment
+- Complete payment gateway solution
+- Secure transaction processing
+- Documentation coming soon
 
-## Repository
+## Links
 
-GitHub: [bloque-app/sdk](https://github.com/bloque-app/sdk)
-NPM: [@bloque/sdk](https://www.npmjs.com/package/@bloque/sdk)
+- Website: [docs.bloque.app](https://docs.bloque.app)

package.json

@@ -5,6 +5,7 @@
   "scripts": {
     "build": "rspress build",
     "dev": "rspress dev",
+    "sync-docs": "bun run ./scripts/sync-docs.ts docs",
     "preview": "rspress preview",
     "deploy": "wrangler pages deploy --branch=main"
   },