docs: streamlined installation & automated Pages deployment

.github/workflows/deploy.yml

@@ -4,6 +4,9 @@ on:
   push:
     branches:
       - main
+  pull_request:
+    branches:
+      - main
   workflow_dispatch:
 
 permissions:
@@ -31,7 +34,10 @@ jobs:
           cache: npm
 
       - name: Setup Pages
+        if: github.event_name != 'pull_request'
         uses: actions/configure-pages@v5
+        with:
+          enablement: true
 
       - name: Install dependencies
         run: npm ci
@@ -40,11 +46,13 @@ jobs:
         run: npm run docs:build
 
       - name: Upload artifact
+        if: github.event_name != 'pull_request'
         uses: actions/upload-pages-artifact@v3
         with:
           path: .vitepress/dist
 
   deploy:
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
     environment:
       name: github-pages
       url: ${{ steps.deployment.outputs.page_url }}

.vitepress/config.mts

@@ -1,16 +1,63 @@
 import { defineConfig } from 'vitepress'
 
 export default defineConfig({
+  srcDir: 'src',
   title: 'DevDeskApp Docs',
   description: 'Official Documentation for DevDeskApp suite, developer utilities, and n8n-nodes-devdeskapp community node.',
   cleanUrls: true,
+  sitemap: {
+    hostname: 'https://docs.devdeskapp.com'
+  },
+  transformHead({ pageData }) {
+    const cleanPath = pageData.relativePath
+      .replace(/index\.md$/, '')
+      .replace(/\.md$/, '')
+    const canonical = cleanPath ? `https://docs.devdeskapp.com/${cleanPath}` : 'https://docs.devdeskapp.com/'
+    return [
+      ['link', { rel: 'canonical', href: canonical }]
+    ]
+  },
   head: [
     ['link', { rel: 'icon', href: '/logo.svg' }],
-    ['meta', { name: 'theme-color', content: '#8b5cf6' }],
-    ['meta', { name: 'og:site_name', content: 'DevDeskApp Docs' }],
-    ['meta', { name: 'og:type', content: 'website' }],
-    ['meta', { name: 'og:title', content: 'DevDeskApp Documentation & Automation Suite' }],
-    ['meta', { name: 'og:description', content: 'Zero-API privacy developer tools and high-performance n8n automation node for developers, HR, and DevOps.' }]
+    ['meta', { name: 'theme-color', content: '#6366f1' }],
+    ['meta', { name: 'robots', content: 'index, follow, max-image-preview:large, max-snippet:-1, max-video-preview:-1' }],
+    ['meta', { property: 'og:site_name', content: 'DevDeskApp Docs' }],
+    ['meta', { property: 'og:type', content: 'website' }],
+    ['meta', { property: 'og:locale', content: 'en_US' }],
+    ['meta', { property: 'og:image', content: 'https://docs.devdeskapp.com/logo-dark.jpg' }],
+    ['meta', { property: 'og:image:width', content: '1200' }],
+    ['meta', { property: 'og:image:height', content: '630' }],
+    ['meta', { name: 'twitter:card', content: 'summary_large_image' }],
+    ['meta', { name: 'twitter:site', content: '@devdeskapp' }],
+    ['meta', { name: 'twitter:image', content: 'https://docs.devdeskapp.com/logo-dark.jpg' }],
+    [
+      'script',
+      { type: 'application/ld+json' },
+      JSON.stringify({
+        '@context': 'https://schema.org',
+        '@graph': [
+          {
+            '@type': 'WebSite',
+            name: 'DevDeskApp Documentation',
+            url: 'https://docs.devdeskapp.com',
+            description: 'Official documentation for DevDeskApp developer utilities, tools, and n8n-nodes-devdeskapp community node.'
+          },
+          {
+            '@type': 'SoftwareApplication',
+            name: 'DevDeskApp n8n Community Node',
+            applicationCategory: 'DeveloperApplication, AutomationTool, AIAgentTool',
+            operatingSystem: 'Cross-platform, Node.js, Docker, Linux, macOS, Windows',
+            description: 'In-memory deterministic utility suite and AI Agent function calling tool for n8n workflows.',
+            url: 'https://docs.devdeskapp.com',
+            offers: {
+              '@type': 'Offer',
+              price: '0',
+              priceCurrency: 'USD'
+            }
+          }
+        ]
+      })
+    ]
   ],
   themeConfig: {
     logo: {
@@ -21,6 +68,7 @@ export default defineConfig({
     nav: [
       { text: 'DevDeskApp Suite', link: '/about/' },
       { text: 'n8n Node Guide', link: '/n8n/' },
+      { text: '🤖 AI Agents & LLMs', link: '/solutions/ai-agents' },
       { text: 'Operations Reference', link: '/n8n/operations' },
       { text: 'Workflow Templates', link: '/n8n/workflow-templates' },
       { text: 'Architecture', link: '/solutions/' },
@@ -57,8 +105,9 @@ export default defineConfig({
       ],
       '/solutions/': [
         {
-          text: 'Solutions & Production',
+          text: 'Solutions & AI',
           items: [
+            { text: '🤖 AI Agents & LLM Calling', link: '/solutions/ai-agents' },
             { text: 'Local Node vs Cloud APIs', link: '/solutions/' },
             { text: 'Production Best Practices', link: '/solutions/best-practices' }
           ]

.vitepress/theme/components/QuickNavGrid.vue

@@ -53,11 +53,22 @@ const cards: NavCard[] = [
     icon: '🌟',
     highlight: true
   },
+  {
+    title: 'AI Agents & LLMs',
+    category: 'Function Calling & Tools',
+    badge: 'LangChain & OpenAI',
+    badgeType: 'purple',
+    description: 'Wire DevDeskApp into n8n AI Agents as zero-latency deterministic tools for payroll, hashing, and JSON compression.',
+    link: '/solutions/ai-agents',
+    linkText: 'AI Agent Guide',
+    icon: '🤖',
+    highlight: true
+  },
   {
     title: 'Enterprise Architecture',
     category: 'Security & Benchmarks',
     badge: 'Zero-Leak Audit',
-    badgeType: 'purple',
+    badgeType: 'indigo',
     description: 'Deep-dive security benchmarks comparing local native Node execution vs external cloud REST APIs.',
     link: '/solutions/',
     linkText: 'Architecture & Solutions',

README.md

@@ -1,54 +1,45 @@
-# 📖 DevDeskApp Official Documentation
+# 📖 DevDeskApp Docs
 
-> Modern Automation & High-Performance Developer Suite • Zero Cloud Data Leaks • 330+ Tools & Official n8n Community Node.
+> Official Documentation Portal for DevDeskApp & `n8n-nodes-devdeskapp` Community Node.
 
-[![Live Docs](https://img.shields.io/badge/docs-docs.devdeskapp.com-6366f1?style=for-the-badge&logo=googlechrome&logoColor=white)](https://docs.devdeskapp.com)
-[![n8n Community Node](https://img.shields.io/badge/n8n-n8n--nodes--devdeskapp-ea4b71?style=for-the-badge&logo=n8n&logoColor=white)](https://www.npmjs.com/package/n8n-nodes-devdeskapp)
-[![Official Template](https://img.shields.io/badge/n8n.io-Template_%2321017-10b981?style=for-the-badge&logo=n8n&logoColor=white)](https://n8n.io/workflows/21017-format-json-and-secure-hr-payloads-with-devdeskapp-utilities)
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge)](LICENSE)
+[![Live Docs](https://img.shields.io/badge/docs-docs.devdeskapp.com-6366f1?style=flat-square&logo=googlechrome&logoColor=white)](https://docs.devdeskapp.com)
+[![NPM](https://img.shields.io/npm/v/n8n-nodes-devdeskapp?color=ea4b71&style=flat-square&logo=npm)](https://www.npmjs.com/package/n8n-nodes-devdeskapp)
+[![Template #21017](https://img.shields.io/badge/n8n.io-Template_%2321017-10b981?style=flat-square&logo=n8n&logoColor=white)](https://n8n.io/workflows/21017-format-json-and-secure-hr-payloads-with-devdeskapp-utilities)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](LICENSE)
 
 ---
 
-## 🌟 Overview
+## ⚡ Quick Install
 
-This repository powers the official documentation portal at **[docs.devdeskapp.com](https://docs.devdeskapp.com)**.
-
-DevDeskApp provides 330+ client-side developer utilities and an official community node (`n8n-nodes-devdeskapp`) that runs formatters, financial calculation engines, and cryptographic algorithms natively in-memory inside n8n workflows with:
-- **Sub-millisecond execution** (< 0.2ms)
-- **Zero cloud API data leaks** (100% in-process Node.js execution)
-- **Zero API keys or external quotas required**
-
----
-
-## 🚀 Quick Links
+### n8n Community Node (UI)
+In n8n: **Settings** &rarr; **Community Nodes** &rarr; **Install**:
+```text
+n8n-nodes-devdeskapp
+```
 
-- 🌐 **Documentation Portal**: [https://docs.devdeskapp.com](https://docs.devdeskapp.com)
-- 📦 **NPM Package**: [`n8n-nodes-devdeskapp`](https://www.npmjs.com/package/n8n-nodes-devdeskapp)
-- 🌟 **n8n Official Template #21017**: [Format JSON & Secure HR Payloads with DevDeskApp](https://n8n.io/workflows/21017-format-json-and-secure-hr-payloads-with-devdeskapp-utilities)
-- 💻 **Main Web App**: [https://www.devdeskapp.com](https://www.devdeskapp.com)
+### Docker / CLI
+```bash
+npm install n8n-nodes-devdeskapp
+```
 
 ---
 
-## 🛠️ Local Development
+## 🛠️ Run Docs Locally
 
-### 1. Install Dependencies
 ```bash
 npm install
+npm run docs:dev     # http://localhost:5173
 ```
 
-### 2. Start Development Server
-```bash
-npm run docs:dev
-```
-Local preview will be available at `http://localhost:5173/`.
+---
 
-### 3. Build for Production
-```bash
-npm run docs:build
-```
+## 🔗 Links
+
+- **Documentation**: [https://docs.devdeskapp.com](https://docs.devdeskapp.com)
+- **Official n8n Template #21017**: [https://n8n.io/workflows/21017](https://n8n.io/workflows/21017-format-json-and-secure-hr-payloads-with-devdeskapp-utilities)
+- **Web App**: [https://www.devdeskapp.com](https://www.devdeskapp.com)
 
 ---
 
 ## 📄 License
-
-Released under the [MIT License](LICENSE). Copyright © 2026 DevDeskApp Community.
+MIT © 2026 DevDeskApp Community