diff --git a/.vitepress/config.mts b/.vitepress/config.mts index 2f984f9..252e423 100644 --- a/.vitepress/config.mts +++ b/.vitepress/config.mts @@ -2,19 +2,31 @@ import { defineConfig } from 'vitepress' export default defineConfig({ srcDir: 'src', + // Files in src/public are static assets (auth.md, llms.txt...). Without this, + // VitePress also renders public/auth.md as an indexable /public/auth page. + srcExclude: ['public/**'], 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 }) { + transformHead({ pageData, title, description }) { + // The 404 page must not claim a canonical URL and must stay out of the index. + if (pageData.isNotFound || pageData.relativePath === '404.md') { + return [['meta', { name: 'robots', content: 'noindex, follow' }]] + } 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 }] + ['link', { rel: 'canonical', href: canonical }], + ['meta', { property: 'og:url', content: canonical }], + ['meta', { property: 'og:title', content: title }], + ['meta', { property: 'og:description', content: description }], + ['meta', { name: 'twitter:title', content: title }], + ['meta', { name: 'twitter:description', content: description }] ] }, head: [ diff --git a/src/about/architecture.md b/src/about/architecture.md index 3bd69a8..60eb8a6 100644 --- a/src/about/architecture.md +++ b/src/about/architecture.md @@ -1,3 +1,7 @@ +--- +title: 'Architecture & Privacy' +description: 'How DevDeskApp keeps data private: client-side processing in the browser and in-memory execution inside n8n, with no payloads sent to external servers.' +--- # Architecture & Privacy DevDeskApp is engineered around a strict local-first and privacy-first architectural paradigm. This document explains how the web platform and automation nodes handle memory, security, and execution isolation. diff --git a/src/about/index.md b/src/about/index.md index 8ecc059..e4c0074 100644 --- a/src/about/index.md +++ b/src/about/index.md @@ -1,3 +1,7 @@ +--- +title: 'About DevDeskApp' +description: 'What DevDeskApp is: a privacy-first suite of 300+ browser-based developer tools, plus an n8n community node that runs the same utilities in your workflows.' +--- # About DevDeskApp DevDeskApp is an all-in-one developer productivity platform and open-source automation utility suite. It provides modern engineering and operations teams with over 330+ developer utilities, calculators, encoders, and workflow tools designed to run with maximum speed and absolute privacy. diff --git a/src/index.md b/src/index.md index e2b68c9..f6e9f96 100644 --- a/src/index.md +++ b/src/index.md @@ -1,5 +1,8 @@ --- layout: page +titleTemplate: false +title: 'DevDeskApp Docs: n8n Node & Developer Utilities' +description: 'Documentation for DevDeskApp and the n8n-nodes-devdeskapp community node: installation, operations, workflow templates and AI agent tool calling.' --- diff --git a/src/n8n/index.md b/src/n8n/index.md index 49f4ab2..e714055 100644 --- a/src/n8n/index.md +++ b/src/n8n/index.md @@ -1,3 +1,7 @@ +--- +title: 'n8n Community Node: DevDeskApp' +description: 'Get started with n8n-nodes-devdeskapp: what the community node does, which operations it offers and how it fits into your n8n workflows.' +--- # n8n Community Node: DevDeskApp `n8n-nodes-devdeskapp` is an official community node for [n8n](https://n8n.io) that brings high-performance, zero-latency developer utilities, formatters, and financial calculation engines directly into your automation pipelines. diff --git a/src/n8n/installation.md b/src/n8n/installation.md index 07dfed6..a94d87b 100644 --- a/src/n8n/installation.md +++ b/src/n8n/installation.md @@ -1,3 +1,7 @@ +--- +title: 'Install the DevDeskApp n8n Node' +description: 'Install n8n-nodes-devdeskapp step by step from the n8n Community Nodes panel, or with npm on self-hosted and Docker n8n instances.' +--- # Step-by-Step Installation Guide You can install `n8n-nodes-devdeskapp` into your n8n instance using the graphical Community Nodes manager or via container/npm deployment scripts. diff --git a/src/n8n/operations.md b/src/n8n/operations.md index 06a9a43..189f6dc 100644 --- a/src/n8n/operations.md +++ b/src/n8n/operations.md @@ -1,3 +1,7 @@ +--- +title: 'n8n Node Operations Reference' +description: 'Reference for every n8n-nodes-devdeskapp operation: inputs, options and output fields for JSON, hashing, UUID, encoding and payroll utilities.' +--- # Operations Reference `n8n-nodes-devdeskapp` provides 4 resources with 13 deterministic operations. Every operation executes synchronously in-memory and outputs cleanly formatted JSON objects. diff --git a/src/n8n/workflow-templates.md b/src/n8n/workflow-templates.md index 0e02f63..fbe9e57 100644 --- a/src/n8n/workflow-templates.md +++ b/src/n8n/workflow-templates.md @@ -1,6 +1,6 @@ --- -title: Official Workflow Templates | DevDeskApp -description: Production-ready, verified n8n workflow blueprints powered by n8n-nodes-devdeskapp. Copy, paste, and automate developer utilities, security hashing, and payroll calculations. +title: 'Workflow Templates for the n8n Node' +description: 'Ready-made n8n workflows built on n8n-nodes-devdeskapp for developer utilities, security hashing and payroll calculation, with setup notes.' --- # Official Workflow Templates diff --git a/src/solutions/ai-agents.md b/src/solutions/ai-agents.md index 5127e44..8733375 100644 --- a/src/solutions/ai-agents.md +++ b/src/solutions/ai-agents.md @@ -1,6 +1,6 @@ --- -title: AI Agents & LLM Function Calling | DevDeskApp -description: Supercharge n8n AI Agents, LangChain, and LLM models with zero-latency deterministic tools. Clean JSON payloads, hash secrets, and calculate payroll in-memory with zero cloud data leaks. +title: 'AI Agents & LLM Function Calling' +description: 'Give n8n AI Agents and LangChain deterministic tools: clean JSON, hash secrets and calculate payroll in memory without sending data to the cloud.' --- # 🤖 AI Agents & LLM Function Calling diff --git a/src/solutions/best-practices.md b/src/solutions/best-practices.md index a0604df..d03d5e1 100644 --- a/src/solutions/best-practices.md +++ b/src/solutions/best-practices.md @@ -1,3 +1,7 @@ +--- +title: 'Production Best Practices' +description: 'Best practices for running n8n-nodes-devdeskapp in production: error handling, input validation, secrets, versioning and monitoring workflows.' +--- # Production Best Practices Implementing automated workflows in production requires attention to data integrity, error boundaries, and throughput optimization. This guide outlines recommended practices when deploying `n8n-nodes-devdeskapp` at scale. diff --git a/src/solutions/index.md b/src/solutions/index.md index 38777cc..3ed06d9 100644 --- a/src/solutions/index.md +++ b/src/solutions/index.md @@ -1,3 +1,7 @@ +--- +title: 'Local n8n Node vs Cloud APIs' +description: 'Why run utilities in a local n8n node instead of calling cloud APIs: latency, cost, rate limits and keeping sensitive data inside your infrastructure.' +--- # Local Node vs Cloud APIs When architecting data transformation and developer utility pipelines in n8n, engineering teams often evaluate whether to use a local native community node or call an external cloud-hosted microservice/API. diff --git a/src/templates/ctc-salary-engine.md b/src/templates/ctc-salary-engine.md index 0735256..78e5844 100644 --- a/src/templates/ctc-salary-engine.md +++ b/src/templates/ctc-salary-engine.md @@ -1,6 +1,6 @@ --- -title: "Template #21130: Employee CTC to In-Hand Salary Engine | DevDeskApp" -description: Complete blueprint and operational guide for official n8n template #21130. Compute Indian payroll components, employee PF, employer PF, professional tax, and net monthly take-home salary. +title: 'Template #21130: CTC to In-Hand Salary Engine' +description: 'n8n template #21130: calculate Indian payroll from CTC, including employee and employer PF, professional tax and net monthly take-home pay.' --- # 💰 Template #21130: Employee CTC to In-Hand Salary Engine diff --git a/src/templates/developer-suite.md b/src/templates/developer-suite.md index 03344b7..2a87ddb 100644 --- a/src/templates/developer-suite.md +++ b/src/templates/developer-suite.md @@ -1,6 +1,6 @@ --- -title: "Template #21017: Developer Suite & Security Engine | DevDeskApp" -description: Complete blueprint and operational guide for official n8n template #21017. Format JSON, calculate SHA-256 digests, generate UUID v4 trace tokens, and evaluate CTC payloads. +title: 'Template #21017: Developer Suite & Security Engine' +description: 'n8n template #21017: format JSON, compute SHA-256 digests, generate UUID v4 trace IDs and evaluate CTC payloads with n8n-nodes-devdeskapp.' --- # 🌟 Template #21017: Developer Suite & Security Engine diff --git a/src/templates/how-to-import.md b/src/templates/how-to-import.md index 6ad6f36..dc48bef 100644 --- a/src/templates/how-to-import.md +++ b/src/templates/how-to-import.md @@ -1,6 +1,6 @@ --- -title: How to Import n8n Templates | DevDeskApp -description: Step-by-step instructions on importing official DevDeskApp templates into self-hosted n8n, n8n Cloud, and local Docker instances via 1-click clipboard paste. +title: 'How to Import n8n Templates' +description: 'Import official DevDeskApp templates into n8n Cloud, self-hosted n8n or Docker by pasting the workflow JSON onto the canvas, step by step.' --- # ⚡ How to Import Templates into n8n diff --git a/src/templates/index.md b/src/templates/index.md index e28c19e..2a56936 100644 --- a/src/templates/index.md +++ b/src/templates/index.md @@ -1,6 +1,6 @@ --- -title: Official n8n Workflow Templates | DevDeskApp -description: Production-ready, verified n8n workflow blueprints powered by n8n-nodes-devdeskapp. Copy, paste, and automate developer utilities, security hashing, and payroll calculations in <0.2ms. +title: 'Official n8n Workflow Templates' +description: 'Catalog of official DevDeskApp n8n templates: developer suite, CTC salary engine and payment webhook sanitizer, each with an import guide.' --- # 📋 Official n8n Workflow Templates diff --git a/src/templates/payment-webhook-sanitizer.md b/src/templates/payment-webhook-sanitizer.md index 9260554..6c2796b 100644 --- a/src/templates/payment-webhook-sanitizer.md +++ b/src/templates/payment-webhook-sanitizer.md @@ -1,6 +1,6 @@ --- -title: "Template #21376: Payment Webhook Sanitizer & Security Audit | DevDeskApp" -description: Complete blueprint and operational guide for official n8n template #21376. Sanitize payment webhooks, calculate cryptographic SHA-256 digests, generate UUID trace tokens, and audit Stripe/Razorpay transactions in <0.2ms. +title: 'Template #21376: Payment Webhook Sanitizer' +description: 'n8n template #21376: sanitize Stripe and Razorpay webhooks, compute SHA-256 digests, add UUID trace IDs and keep an audit trail of payments.' --- # 🛡️ Template #21376: Payment Webhook Sanitizer & Security Audit Pipeline