diff --git a/.cursor/rules/website/main.mdc b/.cursor/rules/website/main.mdc
new file mode 100644
index 0000000000..5a32f49a08
--- /dev/null
+++ b/.cursor/rules/website/main.mdc
@@ -0,0 +1,40 @@
+---
+description: documentation website - source code and content
+globs: docs/website/**
+alwaysApply: false
+---
+
+# Documentation Website
+
+## Language
+
+All generated text MUST be written in English.
+
+## Project Context
+
+QVAC is an OSS ecosystem for developers building local AI applications and systems.
+
+`docs/website` is the developer portal for QVAC project. 
+
+The goal of this context (chat) is to improve this website. This includes: the website source code AND all the resources we provide for our developer-users to be capable of using QVAC — references, tutorials, learning materials, code examples, templates, starter kits, etc.
+
+## Repository Layout
+
+`docs/website/` contains website source code and WITHIN it, `docs/website/content/` contains all content (resources) in MDX files.
+
+## Tech Stack
+
+- **Framework:** Next.js + Fumadocs
+- **Output:** 100% static site. At build time, all HTML pages are generated into `docs/website/out/` and then served from a CDN. There is no server-side runtime.
+
+## Scope of Work
+
+The goal of this context is one of the following or both:
+
+1. Improve website source code: changes to components, configuration, styling, or build pipeline under `docs/website/`
+2. Generate new content: create or update pages under `docs/website/content/`
+
+## Environments
+
+- Production: https://docs.qvac.tether.io
+- Staging: https://docs.qvac.tether.su
\ No newline at end of file
diff --git a/docs/website/.env.example b/docs/website/.env.example
index 1460e411e1..6a93028d48 100644
--- a/docs/website/.env.example
+++ b/docs/website/.env.example
@@ -1,9 +1,6 @@
 # Production docs (Sevalla): set at build time on the app that serves https://docs.qvac.tether.io
 # so static HTML declares index,follow. Omit on preview/staging/PR builds.
-# DOCS_ALLOW_INDEXING=1
-
-# Force noindex in static HTML even when DOCS_ALLOW_INDEXING is set (emergency / wrong environment).
-# DOCS_FORCE_NOINDEX=1
+# DOCS_ALLOW_INDEXING=true
 
 # Inkeep API Key for search and chat functionality
 NEXT_PUBLIC_INKEEP_API_KEY=your_inkeep_api_key_here
diff --git a/docs/website/content/docs/about-qvac/flagship-apps.mdx b/docs/website/content/docs/about-qvac/flagship-apps.mdx
index 9e160aca73..e8bf51d4d2 100644
--- a/docs/website/content/docs/about-qvac/flagship-apps.mdx
+++ b/docs/website/content/docs/about-qvac/flagship-apps.mdx
@@ -2,6 +2,7 @@
 title: Flagship applications
 description: Desktop and mobile apps to empower users and showcase QVAC capabilities.
 ogImage: /og-flagship-apps.png
+schemaType: TechArticle
 ---
 
 ## Overview
diff --git a/docs/website/content/docs/about-qvac/how-it-works.mdx b/docs/website/content/docs/about-qvac/how-it-works.mdx
index 1fb2b2fb71..3b00bb0cf6 100644
--- a/docs/website/content/docs/about-qvac/how-it-works.mdx
+++ b/docs/website/content/docs/about-qvac/how-it-works.mdx
@@ -1,6 +1,7 @@
 ---
 title: How it works
 description: Understand what happens under the hood when you use QVAC SDK in your application.
+schemaType: TechArticle
 ---
 
 ## Overview
diff --git a/docs/website/content/docs/about-qvac/public-launch.mdx b/docs/website/content/docs/about-qvac/public-launch.mdx
index a18b2e20ea..b3340e22c1 100644
--- a/docs/website/content/docs/about-qvac/public-launch.mdx
+++ b/docs/website/content/docs/about-qvac/public-launch.mdx
@@ -1,6 +1,7 @@
 ---
 title:  Public launch
 description: Tether's public launch of QVAC at Plan B Forum Lugano (October 2025) — keynotes from Paolo Ardoino, Subash, and Marco Chiappetta.
+schemaType: TechArticle
 ---
 
 Tether publicly launched QVAC in October 2025 at the Plan B Forum in Lugano. During the forum, Tether CEO Paolo Ardoino presented QVAC's future vision in his keynote, _Fiat Lux_:
diff --git a/docs/website/content/docs/about-qvac/vision.mdx b/docs/website/content/docs/about-qvac/vision.mdx
index 128e5fe48e..5d6b11fadd 100644
--- a/docs/website/content/docs/about-qvac/vision.mdx
+++ b/docs/website/content/docs/about-qvac/vision.mdx
@@ -2,6 +2,7 @@
 title: Our vision
 description: "Tether's vision for QVAC — the Infinite Stable Intelligence Platform — local-first AI at the edge, the foundational layer for the decentralized mind."
 ogImage: /og-vision.png
+schemaType: TechArticle
 ---
 
 ## The world is waking up
diff --git a/docs/website/content/docs/about-qvac/welcome.mdx b/docs/website/content/docs/about-qvac/welcome.mdx
index d7be799038..4bf4398d25 100644
--- a/docs/website/content/docs/about-qvac/welcome.mdx
+++ b/docs/website/content/docs/about-qvac/welcome.mdx
@@ -2,6 +2,7 @@
 title: Welcome
 description: Learn what QVAC is, why Tether built it, and what makes it different.
 ogImage: /og-welcome.png
+schemaType: TechArticle
 ---
 
 ## What is QVAC?
diff --git a/docs/website/content/docs/addons/diffusion-cpp/index.mdx b/docs/website/content/docs/addons/diffusion-cpp/index.mdx
index 7fa51e1a07..8340902d49 100644
--- a/docs/website/content/docs/addons/diffusion-cpp/index.mdx
+++ b/docs/website/content/docs/addons/diffusion-cpp/index.mdx
@@ -2,6 +2,7 @@
 title: "@qvac/diffusion-cpp"
 titleStyle: code
 description: Text-to-image generation from text prompts.
+schemaType: APIReference
 ---
 
 ## Overview
diff --git a/docs/website/content/docs/addons/embed-llamacpp/index.mdx b/docs/website/content/docs/addons/embed-llamacpp/index.mdx
index 862c245ef6..db5cfdf546 100644
--- a/docs/website/content/docs/addons/embed-llamacpp/index.mdx
+++ b/docs/website/content/docs/addons/embed-llamacpp/index.mdx
@@ -2,6 +2,7 @@
 title: "@qvac/embed-llamacpp"
 titleStyle: code
 description: Vector embedding generation for semantic search, clustering, and retrieval that seamlessly supports retrieval-augmented generation workflow.
+schemaType: APIReference
 ---
 
 ## Overview
diff --git a/docs/website/content/docs/addons/index.mdx b/docs/website/content/docs/addons/index.mdx
index 8cdb9e3194..8e27c12790 100644
--- a/docs/website/content/docs/addons/index.mdx
+++ b/docs/website/content/docs/addons/index.mdx
@@ -2,6 +2,7 @@
 title: Addons
 description: Reference for the QVAC components that provide AI capabilities.
 ogImage: /og-addons.png
+schemaType: APIReference
 ---
 
 ## Overview
diff --git a/docs/website/content/docs/addons/llm-llamacpp/index.mdx b/docs/website/content/docs/addons/llm-llamacpp/index.mdx
index 1aeb13a468..74fb23f17a 100644
--- a/docs/website/content/docs/addons/llm-llamacpp/index.mdx
+++ b/docs/website/content/docs/addons/llm-llamacpp/index.mdx
@@ -2,6 +2,7 @@
 title: "@qvac/llm-llamacpp"
 titleStyle: code
 description: LLM inference for text generation and chat with support to images, and other media within a single conversation context.
+schemaType: APIReference
 ---
 
 ## Overview
diff --git a/docs/website/content/docs/addons/ocr-onnx/index.mdx b/docs/website/content/docs/addons/ocr-onnx/index.mdx
index f080d3c9c9..4d16e80e1e 100644
--- a/docs/website/content/docs/addons/ocr-onnx/index.mdx
+++ b/docs/website/content/docs/addons/ocr-onnx/index.mdx
@@ -2,6 +2,7 @@
 title: "@qvac/ocr-onnx"
 titleStyle: code
 description: Optical character recognition (OCR) for extracting text from images.
+schemaType: APIReference
 ---
 
 ## Overview
diff --git a/docs/website/content/docs/addons/transcription-parakeet/index.mdx b/docs/website/content/docs/addons/transcription-parakeet/index.mdx
index 2c19d7ba9c..70ce5442cc 100644
--- a/docs/website/content/docs/addons/transcription-parakeet/index.mdx
+++ b/docs/website/content/docs/addons/transcription-parakeet/index.mdx
@@ -2,6 +2,7 @@
 title: "@qvac/transcription-parakeet"
 titleStyle: code
 description: Automatic speech recognition (ASR) for speech-to-text with speaker diarization.
+schemaType: APIReference
 ---
 
 ## Overview
diff --git a/docs/website/content/docs/addons/transcription-whispercpp/index.mdx b/docs/website/content/docs/addons/transcription-whispercpp/index.mdx
index e1794640ad..86bb28ec73 100644
--- a/docs/website/content/docs/addons/transcription-whispercpp/index.mdx
+++ b/docs/website/content/docs/addons/transcription-whispercpp/index.mdx
@@ -2,6 +2,7 @@
 title: "@qvac/transcription-whispercpp"
 titleStyle: code
 description: Automatic speech recognition (ASR) for speech-to-text.
+schemaType: APIReference
 ---
 
 ## Overview
diff --git a/docs/website/content/docs/addons/translation-nmtcpp/index.mdx b/docs/website/content/docs/addons/translation-nmtcpp/index.mdx
index 8a4c296407..44214d24e2 100644
--- a/docs/website/content/docs/addons/translation-nmtcpp/index.mdx
+++ b/docs/website/content/docs/addons/translation-nmtcpp/index.mdx
@@ -2,6 +2,7 @@
 title: "@qvac/translation-nmtcpp"
 titleStyle: code
 description: Text-to-text neural machine translation (NMT).
+schemaType: APIReference
 ---
 
 > **Migration Note (v1.0.0+):** Opus/Marian model support has been removed. Only IndicTrans2 and Bergamot backends are supported. If you were using Opus models, migrate to Bergamot for European language pairs.
diff --git a/docs/website/content/docs/addons/tts-onnx/index.mdx b/docs/website/content/docs/addons/tts-onnx/index.mdx
index e3cde5488f..6e4aa38447 100644
--- a/docs/website/content/docs/addons/tts-onnx/index.mdx
+++ b/docs/website/content/docs/addons/tts-onnx/index.mdx
@@ -2,6 +2,7 @@
 title: "@qvac/tts-onnx"
 titleStyle: code
 description: Speech synthesis for text-to-speech (TTS).
+schemaType: APIReference
 ---
 
 ## Overview
diff --git a/docs/website/content/docs/cli.mdx b/docs/website/content/docs/cli.mdx
index 9bb9a92917..e70e04a1eb 100644
--- a/docs/website/content/docs/cli.mdx
+++ b/docs/website/content/docs/cli.mdx
@@ -2,6 +2,7 @@
 title: CLI
 description: QVAC CLI provides tools and an HTTP server that exposes an OpenAI-compatible API.
 ogImage: /og-cli.png
+schemaType: TechArticle
 ---
 
 ## Overview
diff --git a/docs/website/content/docs/http-server.mdx b/docs/website/content/docs/http-server.mdx
index 1e69547d64..7b81e14995 100644
--- a/docs/website/content/docs/http-server.mdx
+++ b/docs/website/content/docs/http-server.mdx
@@ -1,6 +1,7 @@
 ---
 title: HTTP server
 description: Run a local HTTP server that exposes an OpenAI-compatible API.
+schemaType: TechArticle
 ---
 
 ## Overview
diff --git a/docs/website/content/docs/sdk/api/index.mdx b/docs/website/content/docs/sdk/api/index.mdx
index 613e86dfe5..9351408b89 100644
--- a/docs/website/content/docs/sdk/api/index.mdx
+++ b/docs/website/content/docs/sdk/api/index.mdx
@@ -1,6 +1,7 @@
 ---
 title: API Summary — v0.9.1 (latest)
 description: One-page reference of all public functions and objects exported by @qvac/sdk
+schemaType: APIReference
 ---
 
 > Auto-generated from `.d.ts` declarations and TSDoc comments.
diff --git a/docs/website/content/docs/sdk/api/v0.7.0.mdx b/docs/website/content/docs/sdk/api/v0.7.0.mdx
index dbbd9814a1..346126e3d9 100644
--- a/docs/website/content/docs/sdk/api/v0.7.0.mdx
+++ b/docs/website/content/docs/sdk/api/v0.7.0.mdx
@@ -1,6 +1,7 @@
 ---
 title: API Summary — v0.7.0
 description: One-page reference of all public functions and objects exported by @qvac/sdk
+schemaType: APIReference
 ---
 
 > Auto-generated from `.d.ts` declarations and TSDoc comments.
diff --git a/docs/website/content/docs/sdk/api/v0.8.0.mdx b/docs/website/content/docs/sdk/api/v0.8.0.mdx
index b46b6c493f..cd209bd341 100644
--- a/docs/website/content/docs/sdk/api/v0.8.0.mdx
+++ b/docs/website/content/docs/sdk/api/v0.8.0.mdx
@@ -1,6 +1,7 @@
 ---
 title: API Summary — v0.8.0
 description: One-page reference of all public functions and objects exported by @qvac/sdk
+schemaType: APIReference
 ---
 
 > Auto-generated from `.d.ts` declarations and TSDoc comments.
diff --git a/docs/website/content/docs/sdk/examples/ai-tasks/completion.mdx b/docs/website/content/docs/sdk/examples/ai-tasks/completion.mdx
index f8bc813b30..c36e95674a 100644
--- a/docs/website/content/docs/sdk/examples/ai-tasks/completion.mdx
+++ b/docs/website/content/docs/sdk/examples/ai-tasks/completion.mdx
@@ -1,6 +1,7 @@
 ---
 title: Completion
 description: LLM inference for text generation and chat — i.e., use a large language model to generate text output based on input prompts and context.
+schemaType: HowTo
 ---
 
 ## Overview
diff --git a/docs/website/content/docs/sdk/examples/ai-tasks/fine-tuning.mdx b/docs/website/content/docs/sdk/examples/ai-tasks/fine-tuning.mdx
index 8eff74b798..1f4a8a0384 100644
--- a/docs/website/content/docs/sdk/examples/ai-tasks/fine-tuning.mdx
+++ b/docs/website/content/docs/sdk/examples/ai-tasks/fine-tuning.mdx
@@ -1,6 +1,7 @@
 ---
 title: Fine-tuning
 description: Adapting LLMs to domain-specific tasks via LoRA — i.e., train small adapter weights on custom datasets to specialize model behavior.
+schemaType: HowTo
 ---
 
 ## Overview
diff --git a/docs/website/content/docs/sdk/examples/ai-tasks/image-generation.mdx b/docs/website/content/docs/sdk/examples/ai-tasks/image-generation.mdx
index 34bb66324b..0a542e9801 100644
--- a/docs/website/content/docs/sdk/examples/ai-tasks/image-generation.mdx
+++ b/docs/website/content/docs/sdk/examples/ai-tasks/image-generation.mdx
@@ -1,6 +1,7 @@
 ---
 title: Image generation
 description: Text-to-image and image-to-image generation using Stable Diffusion.
+schemaType: HowTo
 ---
 
 ## Overview
diff --git a/docs/website/content/docs/sdk/examples/ai-tasks/multimodal.mdx b/docs/website/content/docs/sdk/examples/ai-tasks/multimodal.mdx
index c4b730ff67..d269cebdf4 100644
--- a/docs/website/content/docs/sdk/examples/ai-tasks/multimodal.mdx
+++ b/docs/website/content/docs/sdk/examples/ai-tasks/multimodal.mdx
@@ -1,6 +1,7 @@
 ---
 title: Multimodal
 description: LLM inference over text, images, and other media within a single conversation context.
+schemaType: HowTo
 ---
 
 ## Overview
diff --git a/docs/website/content/docs/sdk/examples/ai-tasks/ocr.mdx b/docs/website/content/docs/sdk/examples/ai-tasks/ocr.mdx
index f3c15a0ce9..ac6bba39f8 100644
--- a/docs/website/content/docs/sdk/examples/ai-tasks/ocr.mdx
+++ b/docs/website/content/docs/sdk/examples/ai-tasks/ocr.mdx
@@ -1,6 +1,7 @@
 ---
 title: OCR
 description: Optical character recognition (OCR) for extracting text from images.
+schemaType: HowTo
 ---
 
 ## Overview
diff --git a/docs/website/content/docs/sdk/examples/ai-tasks/rag.mdx b/docs/website/content/docs/sdk/examples/ai-tasks/rag.mdx
index c3c0fa16f5..169c9556d5 100644
--- a/docs/website/content/docs/sdk/examples/ai-tasks/rag.mdx
+++ b/docs/website/content/docs/sdk/examples/ai-tasks/rag.mdx
@@ -1,6 +1,7 @@
 ---
 title: RAG
 description: Out-of-the-box retrieval-augmented generation workflow.
+schemaType: HowTo
 ---
 
 ## Overview
diff --git a/docs/website/content/docs/sdk/examples/ai-tasks/text-embeddings.mdx b/docs/website/content/docs/sdk/examples/ai-tasks/text-embeddings.mdx
index 63d0a74c2e..e4ab1888ed 100644
--- a/docs/website/content/docs/sdk/examples/ai-tasks/text-embeddings.mdx
+++ b/docs/website/content/docs/sdk/examples/ai-tasks/text-embeddings.mdx
@@ -1,6 +1,7 @@
 ---
 title: Text embeddings
 description: Vector embedding generation for semantic search, clustering, and retrieval.
+schemaType: HowTo
 ---
 
 ## Overview
diff --git a/docs/website/content/docs/sdk/examples/ai-tasks/text-to-speech.mdx b/docs/website/content/docs/sdk/examples/ai-tasks/text-to-speech.mdx
index f4ab926cc3..bae3e504b5 100644
--- a/docs/website/content/docs/sdk/examples/ai-tasks/text-to-speech.mdx
+++ b/docs/website/content/docs/sdk/examples/ai-tasks/text-to-speech.mdx
@@ -1,6 +1,7 @@
 ---
 title: Text-to-Speech
 description: Speech synthesis for text-to-speech (TTS) — i.e., generate audio using custom voices from written input.
+schemaType: HowTo
 ---
 
 ## Overview
diff --git a/docs/website/content/docs/sdk/examples/ai-tasks/transcription.mdx b/docs/website/content/docs/sdk/examples/ai-tasks/transcription.mdx
index 8630da004a..4ed3f360c5 100644
--- a/docs/website/content/docs/sdk/examples/ai-tasks/transcription.mdx
+++ b/docs/website/content/docs/sdk/examples/ai-tasks/transcription.mdx
@@ -1,6 +1,7 @@
 ---
 title: Transcription
 description: Automatic speech recognition (ASR) for speech-to-text — i.e., generate text transcriptions from audio input.
+schemaType: HowTo
 ---
 
 ## Overview
diff --git a/docs/website/content/docs/sdk/examples/ai-tasks/translation.mdx b/docs/website/content/docs/sdk/examples/ai-tasks/translation.mdx
index bb86631775..b894e746bc 100644
--- a/docs/website/content/docs/sdk/examples/ai-tasks/translation.mdx
+++ b/docs/website/content/docs/sdk/examples/ai-tasks/translation.mdx
@@ -1,6 +1,7 @@
 ---
 title: Translation
 description: Text-to-text neural machine translation (NMT) — i.e., translate text between different languages.
+schemaType: HowTo
 ---
 
 ## Overview
diff --git a/docs/website/content/docs/sdk/examples/p2p/blind-relays.mdx b/docs/website/content/docs/sdk/examples/p2p/blind-relays.mdx
index 8d9f42184f..4c1f15f2bc 100644
--- a/docs/website/content/docs/sdk/examples/p2p/blind-relays.mdx
+++ b/docs/website/content/docs/sdk/examples/p2p/blind-relays.mdx
@@ -1,6 +1,7 @@
 ---
 title: Blind relays
 description: Establish peer connections through NAT/firewalls by routing traffic via relay nodes.
+schemaType: HowTo
 ---
 
 ## Overview
diff --git a/docs/website/content/docs/sdk/examples/p2p/delegated-inference.mdx b/docs/website/content/docs/sdk/examples/p2p/delegated-inference.mdx
index a4e8b4a196..a476dfdd28 100644
--- a/docs/website/content/docs/sdk/examples/p2p/delegated-inference.mdx
+++ b/docs/website/content/docs/sdk/examples/p2p/delegated-inference.mdx
@@ -1,6 +1,7 @@
 ---
 title: Delegated inference
 description: Perform peer-to-peer inference delegation out-of-the-box via Holepunch stack, enabling resource sharing.
+schemaType: HowTo
 ---
 
 ## Overview
diff --git a/docs/website/content/docs/sdk/examples/utilities/download-lifecycle.mdx b/docs/website/content/docs/sdk/examples/utilities/download-lifecycle.mdx
index 49d8987470..de4f0cd237 100644
--- a/docs/website/content/docs/sdk/examples/utilities/download-lifecycle.mdx
+++ b/docs/website/content/docs/sdk/examples/utilities/download-lifecycle.mdx
@@ -1,6 +1,7 @@
 ---
 title: Download lifecycle
 description: Pause and resume model downloads.
+schemaType: HowTo
 ---
 
 ## Overview
diff --git a/docs/website/content/docs/sdk/examples/utilities/logging.mdx b/docs/website/content/docs/sdk/examples/utilities/logging.mdx
index be8bd18063..fd794e6cb4 100644
--- a/docs/website/content/docs/sdk/examples/utilities/logging.mdx
+++ b/docs/website/content/docs/sdk/examples/utilities/logging.mdx
@@ -1,6 +1,7 @@
 ---
 title: Logging
 description: Visibility into what's happening during loading, inference, and other operations.
+schemaType: HowTo
 ---
 
 ## Overview
diff --git a/docs/website/content/docs/sdk/examples/utilities/plugin-system.mdx b/docs/website/content/docs/sdk/examples/utilities/plugin-system.mdx
index 604d81b727..47dcd659b7 100644
--- a/docs/website/content/docs/sdk/examples/utilities/plugin-system.mdx
+++ b/docs/website/content/docs/sdk/examples/utilities/plugin-system.mdx
@@ -1,6 +1,7 @@
 ---
 title: Plugin system
 description: Enable and disable built-in AI capabilities, and add new ones via custom plugins.
+schemaType: HowTo
 ---
 
 ## Overview
diff --git a/docs/website/content/docs/sdk/examples/utilities/profiler.mdx b/docs/website/content/docs/sdk/examples/utilities/profiler.mdx
index ffd47054ca..491b762fa7 100644
--- a/docs/website/content/docs/sdk/examples/utilities/profiler.mdx
+++ b/docs/website/content/docs/sdk/examples/utilities/profiler.mdx
@@ -1,6 +1,7 @@
 ---
 title: Profiler
 description: Measure and export timing metrics across model loading, inference, and P2P delegation.
+schemaType: HowTo
 ---
 
 ## Overview
diff --git a/docs/website/content/docs/sdk/examples/utilities/runtime-lifecycle.mdx b/docs/website/content/docs/sdk/examples/utilities/runtime-lifecycle.mdx
index 590f576d31..e6ce53055e 100644
--- a/docs/website/content/docs/sdk/examples/utilities/runtime-lifecycle.mdx
+++ b/docs/website/content/docs/sdk/examples/utilities/runtime-lifecycle.mdx
@@ -1,6 +1,7 @@
 ---
 title: Runtime lifecycle
 description: Suspend and resume the SDK runtime (e.g., when the host app moves to background) and query lifecycle state.
+schemaType: HowTo
 ---
 
 ## Overview
diff --git a/docs/website/content/docs/sdk/examples/utilities/sharded-models.mdx b/docs/website/content/docs/sdk/examples/utilities/sharded-models.mdx
index c8035dbf8f..d09ad9de4d 100644
--- a/docs/website/content/docs/sdk/examples/utilities/sharded-models.mdx
+++ b/docs/website/content/docs/sdk/examples/utilities/sharded-models.mdx
@@ -1,6 +1,7 @@
 ---
 title: Sharded models
 description: Download a model that is sharded into multiple parts.
+schemaType: HowTo
 ---
 
 ## Overview
diff --git a/docs/website/content/docs/sdk/examples/utilities/write-custom-plugin.mdx b/docs/website/content/docs/sdk/examples/utilities/write-custom-plugin.mdx
index de31fb386f..6dace377d5 100644
--- a/docs/website/content/docs/sdk/examples/utilities/write-custom-plugin.mdx
+++ b/docs/website/content/docs/sdk/examples/utilities/write-custom-plugin.mdx
@@ -1,6 +1,7 @@
 ---
 title: Write a custom plugin
 description: Guidelines to ship your custom plugin as a single npm package.
+schemaType: HowTo
 ---
 
 import { File, Folder, Files } from "fumadocs-ui/components/files";
diff --git a/docs/website/content/docs/sdk/getting-started/configuration.mdx b/docs/website/content/docs/sdk/getting-started/configuration.mdx
index 439f9c9e72..32e435ce62 100644
--- a/docs/website/content/docs/sdk/getting-started/configuration.mdx
+++ b/docs/website/content/docs/sdk/getting-started/configuration.mdx
@@ -1,6 +1,7 @@
 ---
 title: Configuration
 description: Use qvac.config.* to configure QVAC's overall behavior.
+schemaType: HowTo
 ---
 
 ## Overview
diff --git a/docs/website/content/docs/sdk/getting-started/index.mdx b/docs/website/content/docs/sdk/getting-started/index.mdx
index 907250aef7..c40d70f2d5 100644
--- a/docs/website/content/docs/sdk/getting-started/index.mdx
+++ b/docs/website/content/docs/sdk/getting-started/index.mdx
@@ -2,6 +2,7 @@
 title: SDK
 description: Use the JS/TS SDK to build local and P2P AI applications and systems.
 ogImage: /og-sdk-main.png
+schemaType: TechArticle
 ---
 
 ## Overview
diff --git a/docs/website/content/docs/sdk/getting-started/installation.mdx b/docs/website/content/docs/sdk/getting-started/installation.mdx
index defd19922c..0ab68ea0b2 100644
--- a/docs/website/content/docs/sdk/getting-started/installation.mdx
+++ b/docs/website/content/docs/sdk/getting-started/installation.mdx
@@ -2,6 +2,7 @@
 title: Installation
 description: Supported environments and how to install the SDK for each one.
 ogImage: /og-sdk-installation.png
+schemaType: HowTo
 ---
 
 ## Supported environments
diff --git a/docs/website/content/docs/sdk/getting-started/quickstart.mdx b/docs/website/content/docs/sdk/getting-started/quickstart.mdx
index 860fd07a33..91545d0089 100644
--- a/docs/website/content/docs/sdk/getting-started/quickstart.mdx
+++ b/docs/website/content/docs/sdk/getting-started/quickstart.mdx
@@ -2,6 +2,7 @@
 title: Quickstart
 description: Run your first example using the JS/TS SDK. At the end, you'll find instructions to run any example in this documentation.
 ogImage: /og-sdk-quickstart.png
+schemaType: HowTo
 ---
 
 ## Requirements
diff --git a/docs/website/content/docs/sdk/release-notes/index.mdx b/docs/website/content/docs/sdk/release-notes/index.mdx
index 45b953e038..9a1c3c796d 100644
--- a/docs/website/content/docs/sdk/release-notes/index.mdx
+++ b/docs/website/content/docs/sdk/release-notes/index.mdx
@@ -1,6 +1,7 @@
 ---
 title: SDK Release Notes — v0.9.1
 description: QVAC SDK release notes
+schemaType: TechArticle
 ---
 
 📦 **NPM:** https://www.npmjs.com/package/@qvac/sdk/v/0.9.1
diff --git a/docs/website/content/docs/sdk/release-notes/v0.7.0.mdx b/docs/website/content/docs/sdk/release-notes/v0.7.0.mdx
index 7db97e2df3..1019f70795 100644
--- a/docs/website/content/docs/sdk/release-notes/v0.7.0.mdx
+++ b/docs/website/content/docs/sdk/release-notes/v0.7.0.mdx
@@ -1,6 +1,7 @@
 ---
 title: SDK Release Notes — v0.7.0
 description: QVAC SDK release notes
+schemaType: TechArticle
 ---
 
 📦 **NPM:** https://www.npmjs.com/package/@qvac/sdk/v/0.7.0
diff --git a/docs/website/content/docs/sdk/release-notes/v0.8.0.mdx b/docs/website/content/docs/sdk/release-notes/v0.8.0.mdx
index 9a6b376ba1..bf66afe875 100644
--- a/docs/website/content/docs/sdk/release-notes/v0.8.0.mdx
+++ b/docs/website/content/docs/sdk/release-notes/v0.8.0.mdx
@@ -1,6 +1,7 @@
 ---
 title: SDK Release Notes — v0.8.0
 description: QVAC SDK release notes
+schemaType: TechArticle
 ---
 
 📦 **NPM:** https://www.npmjs.com/package/@qvac/sdk/v/0.8.0
diff --git a/docs/website/content/docs/sdk/release-notes/v0.9.0.mdx b/docs/website/content/docs/sdk/release-notes/v0.9.0.mdx
index 8c3512658b..15b553769a 100644
--- a/docs/website/content/docs/sdk/release-notes/v0.9.0.mdx
+++ b/docs/website/content/docs/sdk/release-notes/v0.9.0.mdx
@@ -1,6 +1,7 @@
 ---
 title: SDK Release Notes — v0.9.0
 description: QVAC SDK release notes
+schemaType: TechArticle
 ---
 
 📦 **NPM:** https://www.npmjs.com/package/@qvac/sdk/v/0.9.0
diff --git a/docs/website/content/docs/sdk/tutorials/electron.mdx b/docs/website/content/docs/sdk/tutorials/electron.mdx
index c6cae6aac5..b67e0f59f4 100644
--- a/docs/website/content/docs/sdk/tutorials/electron.mdx
+++ b/docs/website/content/docs/sdk/tutorials/electron.mdx
@@ -1,6 +1,7 @@
 ---
 title: Build an Electron app
 description: Hands-on tutorial on using QVAC SDK with Electron.
+schemaType: LearningResource
 ---
 
 ## What we'll build
diff --git a/docs/website/content/docs/sdk/tutorials/expo.mdx b/docs/website/content/docs/sdk/tutorials/expo.mdx
index 71af2312d2..4e70c1479a 100644
--- a/docs/website/content/docs/sdk/tutorials/expo.mdx
+++ b/docs/website/content/docs/sdk/tutorials/expo.mdx
@@ -1,6 +1,7 @@
 ---
 title: Build an Expo app
 description: Hands-on tutorial on using QVAC SDK with Expo.
+schemaType: LearningResource
 ---
 
 ## What we'll build
diff --git a/docs/website/content/docs/system-requirements.mdx b/docs/website/content/docs/system-requirements.mdx
index 58e044f871..411af6c58d 100644
--- a/docs/website/content/docs/system-requirements.mdx
+++ b/docs/website/content/docs/system-requirements.mdx
@@ -1,6 +1,7 @@
 ---
 title: System requirements
 description: Host requirements for running QVAC SDK and CLI, validated by `qvac doctor`.
+schemaType: TechArticle
 ---
 
 ## Overview
diff --git a/docs/website/source.config.ts b/docs/website/source.config.ts
index 3779843bf6..72ad2b6fbd 100644
--- a/docs/website/source.config.ts
+++ b/docs/website/source.config.ts
@@ -4,12 +4,14 @@ import {
   frontmatterSchema,
   metaSchema,
 } from 'fumadocs-mdx/config';
+import lastModified from 'fumadocs-mdx/plugins/last-modified';
 import { remarkMdxMermaid } from 'fumadocs-core/mdx-plugins';
 import { z } from "zod";
 import { resolve } from 'path';
 import rehypeKatex from 'rehype-katex';
 import remarkMath from 'remark-math';
 import codeImport from 'remark-code-import';
+import { SCHEMA_TYPES } from './src/lib/docs-json-ld';
 
 const monorepoRoot = resolve(process.cwd(), '../..');
 
@@ -21,6 +23,7 @@ export const docs = defineDocs({
       titleStyle: z.enum(["code", "text"]).optional(),
       version: z.string().optional(),
       ogImage: z.string().optional(),
+      schemaType: z.enum(SCHEMA_TYPES).optional(),
     }),
     postprocess: {
       includeProcessedMarkdown: true,
@@ -32,6 +35,9 @@ export const docs = defineDocs({
 });
 
 export default defineConfig({
+  // Injects `page.data.lastModified: Date` from `git log -1` per MDX file at build time.
+  // Consumed by `app/sitemap.ts` to emit `<lastmod>` entries.
+  plugins: [lastModified()],
   mdxOptions: {
     remarkPlugins: [
       remarkMath,
diff --git a/docs/website/src/app/(docs)/[[...slug]]/page.tsx b/docs/website/src/app/(docs)/[[...slug]]/page.tsx
index 628e857272..f9012c063e 100644
--- a/docs/website/src/app/(docs)/[[...slug]]/page.tsx
+++ b/docs/website/src/app/(docs)/[[...slug]]/page.tsx
@@ -14,8 +14,9 @@ import { cloneElement, isValidElement } from "react";
 import { LLMCopyButton, ViewOptions, VersionSelector } from '@/components/page-actions';
 import {
   buildCanonicalDocsUrl,
-  inferDiataxisOpenGraph,
+  isArchivedVersionSlug,
 } from '@/lib/docs-open-graph';
+import { buildDocsJsonLd } from '@/lib/docs-json-ld';
 import { QVAC_DOC_OG_HEIGHT, QVAC_DOC_OG_WIDTH } from '@/lib/qvac-doc-og';
 
 function TitleText({
@@ -57,9 +58,20 @@ export default async function Page(props: PageProps<'/[[...slug]]'>) {
 
   // Filter ToC to include H2 through H5 (depth 2, 3, 4, and 5)
   const filteredToc = page.data.toc?.filter(item => item.depth >= 2 && item.depth <= 5) || [];
-  
+
+  const isHomePage = !params.slug || params.slug.length === 0;
+  const jsonLdBlocks = buildDocsJsonLd(page, params.slug ?? [], isHomePage);
+
   return (
-    <DocsPage toc={filteredToc} tableOfContent={{ style: "clerk" }} tableOfContentPopover={{ style: "clerk" }} full={page.data.full}>
+    <>
+      {jsonLdBlocks?.map((block, i) => (
+        <script
+          key={i}
+          type="application/ld+json"
+          dangerouslySetInnerHTML={{ __html: JSON.stringify(block) }}
+        />
+      ))}
+      <DocsPage toc={filteredToc} tableOfContent={{ style: "clerk" }} tableOfContentPopover={{ style: "clerk" }} full={page.data.full}>
       <DocsTitle>
         <span className="inline-flex items-center gap-2 leading-none">
           {titleIcon ? (
@@ -91,6 +103,7 @@ export default async function Page(props: PageProps<'/[[...slug]]'>) {
         />
       </DocsBody>
     </DocsPage>
+    </>
   );
 }
 
@@ -108,12 +121,18 @@ export async function generateMetadata(
 
   const { title, description } = page.data;
   const canonicalUrl = buildCanonicalDocsUrl(params.slug);
-  const { section, tags } = inferDiataxisOpenGraph(page.path);
   const ogImage = getPageImage(page);
+  // Non-canonical bundles (dev + vX.Y.Z) are hidden from search engines and
+  // LLM training channels via per-page noindex. Canonical/OG/Twitter stay
+  // intact so shared links still render a rich social card; `noindex` makes
+  // the canonical pointer inert for Google even when its target was removed
+  // in latest (e.g., `ping` existed in v0.7.0 but not in v0.8.0+).
+  const isArchived = isArchivedVersionSlug(params.slug);
 
   return {
     title: isHomePage ? { absolute: title } : title,
     description,
+    ...(isArchived && { robots: { index: false, follow: true } }),
     alternates: {
       canonical: canonicalUrl,
     },
@@ -123,9 +142,7 @@ export async function generateMetadata(
       url: canonicalUrl,
       siteName: 'QVAC',
       locale: 'en_US',
-      type: 'article',
-      section,
-      tags,
+      type: isHomePage ? 'website' : 'article',
       images: [
         {
           url: ogImage.url,
diff --git a/docs/website/src/app/llms-full.txt/route.ts b/docs/website/src/app/llms-full.txt/route.ts
index bba97f01aa..370c6958e6 100644
--- a/docs/website/src/app/llms-full.txt/route.ts
+++ b/docs/website/src/app/llms-full.txt/route.ts
@@ -1,11 +1,17 @@
 import { source } from '@/lib/source';
 import { getLLMText } from '@/lib/get-llm-text';
+import { isArchivedVersionSlug } from '@/lib/docs-open-graph';
 
 // cached forever
 export const revalidate = false;
 
 export async function GET() {
-  const scan = source.getPages().map(getLLMText);
+  // Non-canonical bundles (dev + vX.Y.Z) are excluded so the full LLM dump
+  // only contains the latest canonical documentation.
+  const scan = source
+    .getPages()
+    .filter((page) => !isArchivedVersionSlug(page.slugs))
+    .map(getLLMText);
   const scanned = await Promise.all(scan);
 
   return new Response(scanned.join('\n\n'));
diff --git a/docs/website/src/app/llms.txt/route.ts b/docs/website/src/app/llms.txt/route.ts
index b1c6e25c1b..d58a9b27c0 100644
--- a/docs/website/src/app/llms.txt/route.ts
+++ b/docs/website/src/app/llms.txt/route.ts
@@ -1,10 +1,15 @@
 import { source } from '@/lib/source';
 import { LATEST_VERSION } from '@/lib/versions';
+import { isArchivedVersionSlug } from '@/lib/docs-open-graph';
 
 export const revalidate = false;
 
 export function GET() {
-  const pages = source.getPages();
+  // Non-canonical bundles (dev + vX.Y.Z) are excluded so the LLM index
+  // only advertises the latest canonical documentation.
+  const pages = source
+    .getPages()
+    .filter((page) => !isArchivedVersionSlug(page.slugs));
   const index = [
     '# QVAC Documentation (llms.txt)',
     '',
diff --git a/docs/website/src/app/robots.txt/route.ts b/docs/website/src/app/robots.txt/route.ts
new file mode 100644
index 0000000000..e587abd192
--- /dev/null
+++ b/docs/website/src/app/robots.txt/route.ts
@@ -0,0 +1,77 @@
+import { allowDocsIndexingAtBuildTime } from '@/lib/docs-indexing';
+import { DOCS_SITE_ORIGIN } from '@/lib/docs-open-graph';
+
+// Required for `output: 'export'` — resolves the response at build time so the
+// result is written to `out/robots.txt` as a static file.
+export const dynamic = 'force-static';
+
+/**
+ * AI crawler user agents that receive an explicit per-User-agent block in
+ * production `robots.txt`. Listed per RFC 9309 guidance so consent is
+ * unambiguous on a per-crawler basis instead of being implied by `User-agent: *`.
+ *
+ * @see https://www.rfc-editor.org/rfc/rfc9309
+ */
+export const AI_BOT_USER_AGENTS = [
+  'GPTBot',
+  'OAI-SearchBot',
+  'Claude-Web',
+  'Google-Extended',
+  'Amazonbot',
+  'anthropic-ai',
+  'Bytespider',
+  'CCBot',
+  'Applebot-Extended',
+] as const;
+
+/**
+ * Content Signals directive declaring permissive content usage preferences
+ * (search indexing, AI input/grounding, and AI training are all allowed).
+ * Mirrors the allow-all robots policy.
+ *
+ * @see https://contentsignals.org/
+ * @see https://datatracker.ietf.org/doc/draft-romm-aipref-contentsignals/
+ */
+const CONTENT_SIGNAL = 'Content-Signal: ai-train=yes, search=yes, ai-input=yes';
+
+function buildUserAgentBlock(userAgent: string): string {
+  return `User-agent: ${userAgent}\n${CONTENT_SIGNAL}\nAllow: /`;
+}
+
+/**
+ * Generates `/robots.txt` at build time as a plain-text response.
+ *
+ * Implemented as an App Router Route Handler (instead of the Next
+ * `MetadataRoute.Robots` helper) because the helper's schema is closed and
+ * cannot emit custom directives like `Content-Signal:`.
+ *
+ * Indexing policy (allow all) — complements `docsRootMetadataRobots()` in
+ * `layout.tsx`:
+ * - Production (`DOCS_ALLOW_INDEXING=true`): permissive for all crawlers. The
+ *   wildcard `User-agent: *` plus each AI crawler in `AI_BOT_USER_AGENTS` get
+ *   their own block per RFC 9309. Each block carries `Content-Signal:
+ *   ai-train=yes, search=yes, ai-input=yes` and `Allow: /`. The sitemap is
+ *   declared at the bottom so crawlers can discover the page inventory.
+ *
+ *   `Content-Signal:` is repeated in every block because per RFC 9309 §2.2.1
+ *   a crawler obeys the most specific matching User-agent group only — it
+ *   does not fall back to the wildcard for additional directives. Without
+ *   per-block repetition, AI bots that match their own explicit block would
+ *   never see the signal.
+ * - Preview / local / PR builds (default): a single wildcard `Disallow: /`
+ *   keeps non-canonical deploys out of search and AI indexes. Per-bot blocks
+ *   and Content-Signal are intentionally omitted — nothing is indexed and the
+ *   wildcard already covers every crawler.
+ *
+ * @see https://www.rfc-editor.org/rfc/rfc9309
+ * @see https://contentsignals.org/
+ */
+export function GET() {
+  if (!allowDocsIndexingAtBuildTime()) {
+    return new Response('User-agent: *\nDisallow: /\n');
+  }
+
+  const blocks = ['*', ...AI_BOT_USER_AGENTS].map(buildUserAgentBlock);
+  const body = `${blocks.join('\n\n')}\n\nSitemap: ${DOCS_SITE_ORIGIN}/sitemap.xml\n`;
+  return new Response(body);
+}
diff --git a/docs/website/src/app/sitemap.ts b/docs/website/src/app/sitemap.ts
new file mode 100644
index 0000000000..7988abf567
--- /dev/null
+++ b/docs/website/src/app/sitemap.ts
@@ -0,0 +1,41 @@
+import type { MetadataRoute } from 'next';
+import { source } from '@/lib/source';
+import { allowDocsIndexingAtBuildTime } from '@/lib/docs-indexing';
+import {
+  buildCanonicalDocsUrl,
+  isArchivedVersionSlug,
+} from '@/lib/docs-open-graph';
+
+// Required for `output: 'export'` — resolves `sitemap()` at build time so the
+// result is written to `out/sitemap.xml` as a static file.
+export const dynamic = 'force-static';
+
+/**
+ * Generates `/sitemap.xml` at build time.
+ *
+ * Indexing policy — mirrors `robots.ts`:
+ * - Production (`DOCS_ALLOW_INDEXING=true`): emit one entry per latest page.
+ * - Preview / local / PR builds (default): emit an empty sitemap so non-canonical
+ *   deploys don't advertise any URLs even if the file is fetched directly.
+ *
+ * Non-canonical bundles (`dev` preview + `vX.Y.Z` back-versions) are excluded
+ * entirely. Those pages still render so the in-page version selector keeps
+ * working, but each one is marked `noindex` by `generateMetadata`, and we do
+ * not advertise them here. Single source of truth for external crawlers and
+ * AI training channels: the latest bundle.
+ *
+ * Fields per entry are intentionally minimal (`url` + `lastModified`). Google
+ * and Bing have publicly stated that `changeFrequency` and `priority` are
+ * ignored, so they would only add noise.
+ */
+export default function sitemap(): MetadataRoute.Sitemap {
+  if (!allowDocsIndexingAtBuildTime()) return [];
+
+  return source
+    .getPages()
+    .filter((page) => !isArchivedVersionSlug(page.slugs))
+    .map((page) => ({
+      url: buildCanonicalDocsUrl(page.slugs),
+      lastModified: (page.data as { lastModified?: Date }).lastModified,
+    }));
+}
diff --git a/docs/website/src/lib/docs-indexing.ts b/docs/website/src/lib/docs-indexing.ts
index 707b821145..60aeaf302e 100644
--- a/docs/website/src/lib/docs-indexing.ts
+++ b/docs/website/src/lib/docs-indexing.ts
@@ -6,16 +6,12 @@ import type { Metadata } from 'next';
  * preview, PR, and local builds.
  *
  * Enable indexing only for the deploy that serves `https://docs.qvac.tether.io`.
- * On Sevalla, set **`DOCS_ALLOW_INDEXING=1`** for that application at **build time**
- * (Next reads this when generating static metadata).
- *
- * Optional: `DOCS_FORCE_NOINDEX=1` forces noindex even when `DOCS_ALLOW_INDEXING` is set.
+ * On Sevalla, set **`DOCS_ALLOW_INDEXING=true`** for that application at **build
+ * time** (Next reads this when generating static metadata). Case-insensitive;
+ * any other value (including `1`) is treated as false.
  */
 export function allowDocsIndexingAtBuildTime() {
-  if (process.env.DOCS_FORCE_NOINDEX === '1' || process.env.DOCS_FORCE_NOINDEX === 'true') {
-    return false;
-  }
-  return process.env.DOCS_ALLOW_INDEXING === '1' || process.env.DOCS_ALLOW_INDEXING === 'true';
+  return process.env.DOCS_ALLOW_INDEXING?.toLowerCase() === 'true';
 }
 
 export function docsRootMetadataRobots(): Metadata['robots'] {
diff --git a/docs/website/src/lib/docs-json-ld.ts b/docs/website/src/lib/docs-json-ld.ts
new file mode 100644
index 0000000000..ab41c48a9c
--- /dev/null
+++ b/docs/website/src/lib/docs-json-ld.ts
@@ -0,0 +1,169 @@
+/**
+ * JSON-LD (Schema.org) structured-data builders for documentation pages.
+ *
+ * Emits schema blocks consumed by search engines (Google rich results) and
+ * AI crawlers for stronger semantic understanding of page content. Relies on
+ * frontmatter `schemaType` for explicit typing; defaults to `TechArticle`.
+ *
+ * @see https://schema.org/
+ * @see https://developers.google.com/search/docs/appearance/structured-data
+ */
+
+import {
+  DOCS_SITE_ORIGIN,
+  buildCanonicalDocsUrl,
+  isArchivedVersionSlug,
+} from './docs-open-graph';
+
+export const SCHEMA_TYPES = [
+  'APIReference',
+  'TechArticle',
+  'HowTo',
+  'LearningResource',
+  'WebSite',
+] as const;
+
+export type SchemaType = (typeof SCHEMA_TYPES)[number];
+
+const PUBLISHER = {
+  '@type': 'Organization',
+  name: 'Tether',
+  url: 'https://tether.io',
+} as const;
+
+/** Minimal structural shape of the Fumadocs page used by the builders below. */
+type DocsPageLike = {
+  data: {
+    title?: string;
+    description?: string;
+    schemaType?: SchemaType;
+    lastModified?: Date;
+  };
+};
+
+type JsonLdBlock = Record<string, unknown>;
+
+function getDocsSchemaType(page: DocsPageLike): SchemaType {
+  return page.data.schemaType ?? 'TechArticle';
+}
+
+function getLastModifiedISO(page: DocsPageLike): string | undefined {
+  const last = page.data.lastModified;
+  if (!last) return undefined;
+  const date = last instanceof Date ? last : new Date(last);
+  return Number.isNaN(date.getTime()) ? undefined : date.toISOString();
+}
+
+/**
+ * Build `BreadcrumbList` for non-home pages.
+ *
+ * Names come from raw slugs (no dictionary / Fumadocs lookup yet). Intermediate
+ * items include an `item` URL; the final item (current page) omits it so search
+ * engines treat the tail as the active page.
+ */
+function buildBreadcrumbList(slugs: string[]): JsonLdBlock {
+  const items: JsonLdBlock[] = [
+    {
+      '@type': 'ListItem',
+      position: 1,
+      name: 'Docs',
+      item: `${DOCS_SITE_ORIGIN}/`,
+    },
+  ];
+
+  let accumulatedPath = '';
+  for (let i = 0; i < slugs.length - 1; i++) {
+    accumulatedPath += `/${encodeURIComponent(slugs[i])}`;
+    items.push({
+      '@type': 'ListItem',
+      position: i + 2,
+      name: slugs[i],
+      item: `${DOCS_SITE_ORIGIN}${accumulatedPath}`,
+    });
+  }
+
+  items.push({
+    '@type': 'ListItem',
+    position: slugs.length + 1,
+    name: slugs[slugs.length - 1],
+  });
+
+  return {
+    '@context': 'https://schema.org',
+    '@type': 'BreadcrumbList',
+    itemListElement: items,
+  };
+}
+
+/**
+ * Home page emits two sibling blocks:
+ * 1. `WebSite` — identifies the documentation site itself.
+ * 2. `SoftwareApplication` — identifies QVAC as the documented product.
+ *
+ * No `SearchAction`: search is client-side (Fumadocs API), with no public
+ * `/search?q=` URL to advertise.
+ */
+function buildHomeBlocks(): JsonLdBlock[] {
+  return [
+    {
+      '@context': 'https://schema.org',
+      '@type': 'WebSite',
+      name: 'QVAC Documentation',
+      url: `${DOCS_SITE_ORIGIN}/`,
+      publisher: PUBLISHER,
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'SoftwareApplication',
+      name: 'QVAC',
+      description:
+        'Quantum Versatile AI Compute — local-first, peer-to-peer AI framework for developers.',
+      applicationCategory: 'DeveloperApplication',
+      operatingSystem: 'Linux, macOS, Windows, Android',
+      publisher: PUBLISHER,
+    },
+  ];
+}
+
+function buildMainPageBlock(page: DocsPageLike, slugs: string[]): JsonLdBlock {
+  const type = getDocsSchemaType(page);
+  const url = buildCanonicalDocsUrl(slugs);
+  const title = page.data.title ?? '';
+  const description = page.data.description ?? '';
+  const lastModifiedISO = getLastModifiedISO(page);
+
+  // `TechArticle` uses `headline`; other Schema.org types here use `name`.
+  const titleField: JsonLdBlock =
+    type === 'TechArticle' ? { headline: title } : { name: title };
+
+  const dateFields: JsonLdBlock = lastModifiedISO
+    ? { dateModified: lastModifiedISO, datePublished: lastModifiedISO }
+    : {};
+
+  return {
+    '@context': 'https://schema.org',
+    '@type': type,
+    ...titleField,
+    description,
+    url,
+    publisher: PUBLISHER,
+    ...dateFields,
+  };
+}
+
+function buildPageBlocks(page: DocsPageLike, slugs: string[]): JsonLdBlock[] {
+  return [buildMainPageBlock(page, slugs), buildBreadcrumbList(slugs)];
+}
+
+/**
+ * Returns the JSON-LD blocks to render for `page`, or `null` when no
+ * structured data should be emitted (archived version bundles).
+ */
+export function buildDocsJsonLd(
+  page: DocsPageLike,
+  slugs: string[],
+  isHomePage: boolean,
+): JsonLdBlock[] | null {
+  if (isArchivedVersionSlug(slugs)) return null;
+  return isHomePage ? buildHomeBlocks() : buildPageBlocks(page, slugs);
+}
diff --git a/docs/website/src/lib/docs-open-graph.ts b/docs/website/src/lib/docs-open-graph.ts
index 2336876744..9f1f348488 100644
--- a/docs/website/src/lib/docs-open-graph.ts
+++ b/docs/website/src/lib/docs-open-graph.ts
@@ -1,107 +1,25 @@
 /**
- * Open Graph helpers for documentation pages — canonical URLs, Diátaxis-inspired sections.
+ * Open Graph helpers for documentation pages — canonical URLs and version slug detection.
  * @see https://ogp.me/
- * @see https://diataxis.fr/
  */
 
 export const DOCS_SITE_ORIGIN = 'https://docs.qvac.tether.io';
 
-export function canonicalDocsPathname(slugs: string[] | undefined): string {
-  if (!slugs?.length) return '/';
-  return '/' + slugs.map((s) => encodeURIComponent(s)).join('/');
-}
-
-export function buildCanonicalDocsUrl(slugs: string[] | undefined): string {
-  const path = canonicalDocsPathname(slugs);
-  if (path === '/') return `${DOCS_SITE_ORIGIN}/`;
-  return `${DOCS_SITE_ORIGIN}${path}`;
-}
-
-export interface DiataxisOpenGraph {
-  section: string;
-  tags: string[];
-}
-
-function referenceTags(extra: string[]): string[] {
-  return ['qvac', 'reference', ...extra];
-}
+const VERSION_SLUG_RE = /^v\d+\.\d+\.\d+$/;
 
 /**
- * Map a Fumadocs virtual path (relative to `content/docs/`) to Diátaxis
- * quadrants for `article:section` and refinement tags.
- *
- * Versioned API summary and release-notes files (e.g. `sdk/api/v0.8.0.mdx`)
- * are still classified as `Reference` — the version segment lives in the
- * filename, not in a folder, so we match by directory only.
+ * True for pages served from a released `vX.Y.Z` back-version bundle. Used by
+ * sitemap, llms.txt/llms-full.txt, and per-page metadata to mark the page
+ * `noindex` so crawlers and LLM training channels only see the latest
+ * canonical documentation.
  */
-export function inferDiataxisOpenGraph(virtualPath: string): DiataxisOpenGraph {
-  const rel = virtualPath.toLowerCase();
-
-  if (rel.startsWith('sdk/api/') || rel === 'sdk/api/index.mdx') {
-    return {
-      section: 'Reference',
-      tags: referenceTags(['sdk', 'api']),
-    };
-  }
-
-  if (rel.startsWith('sdk/release-notes/')) {
-    return {
-      section: 'Reference',
-      tags: referenceTags(['sdk', 'release-notes']),
-    };
-  }
-
-  if (rel.startsWith('tutorials/') || rel.startsWith('sdk/tutorials/')) {
-    return {
-      section: 'Tutorial',
-      tags: ['qvac', 'sdk', 'tutorial'],
-    };
-  }
-
-  if (rel.startsWith('sdk/getting-started/')) {
-    return {
-      section: 'getting-started',
-      tags: ['qvac', 'sdk', 'getting-started'],
-    };
-  }
-
-  if (rel.startsWith('sdk/examples/')) {
-    return {
-      section: 'Usage examples',
-      tags: ['qvac', 'sdk', 'usage-examples', 'how-to'],
-    };
-  }
-
-  if (rel.startsWith('addons/')) {
-    return {
-      section: 'Reference',
-      tags: referenceTags(['addons']),
-    };
-  }
-
-  if (rel.startsWith('about-qvac/')) {
-    return {
-      section: 'Explanation',
-      tags: ['qvac', 'overview', 'explanation'],
-    };
-  }
-
-  if (rel === 'cli.mdx' || rel === 'http-server.mdx') {
-    return {
-      section: 'Reference',
-      tags: referenceTags(rel === 'cli.mdx' ? ['cli'] : ['http-server']),
-    };
-  }
-
-  if (rel === 'index.mdx') {
-    return {
-      section: 'Explanation',
-      tags: ['qvac', 'home', 'explanation'],
-    };
-  }
+export function isArchivedVersionSlug(slugs: string[] | undefined): boolean {
+  if (!slugs?.length) return false;
+  return VERSION_SLUG_RE.test(slugs[0]);
+}
 
-  return {
-    section: 'Documentation',
-    tags: ['qvac', 'documentation'],
-  };
+export function buildCanonicalDocsUrl(slugs: string[] | undefined): string {
+  if (!slugs?.length) return `${DOCS_SITE_ORIGIN}/`;
+  const path = slugs.map((s) => encodeURIComponent(s)).join('/');
+  return `${DOCS_SITE_ORIGIN}/${path}`;
 }
diff --git a/docs/website/tests/docs-indexing.test.ts b/docs/website/tests/docs-indexing.test.ts
index 9a700a3193..ec15b2fcf5 100644
--- a/docs/website/tests/docs-indexing.test.ts
+++ b/docs/website/tests/docs-indexing.test.ts
@@ -8,30 +8,43 @@ afterEach(() => {
 describe('allowDocsIndexingAtBuildTime', () => {
   it('is false when no relevant env is set', () => {
     vi.stubEnv('DOCS_ALLOW_INDEXING', '');
-    vi.stubEnv('DOCS_FORCE_NOINDEX', '');
     expect(allowDocsIndexingAtBuildTime()).toBe(false);
   });
 
-  it('is true when DOCS_ALLOW_INDEXING=1', () => {
-    vi.stubEnv('DOCS_ALLOW_INDEXING', '1');
+  it('is true when DOCS_ALLOW_INDEXING=true', () => {
+    vi.stubEnv('DOCS_ALLOW_INDEXING', 'true');
     expect(allowDocsIndexingAtBuildTime()).toBe(true);
   });
 
-  it('is true when DOCS_ALLOW_INDEXING=true', () => {
-    vi.stubEnv('DOCS_ALLOW_INDEXING', 'true');
+  it('is true when DOCS_ALLOW_INDEXING=TRUE (case-insensitive)', () => {
+    vi.stubEnv('DOCS_ALLOW_INDEXING', 'TRUE');
+    expect(allowDocsIndexingAtBuildTime()).toBe(true);
+  });
+
+  it('is true when DOCS_ALLOW_INDEXING=True (case-insensitive)', () => {
+    vi.stubEnv('DOCS_ALLOW_INDEXING', 'True');
     expect(allowDocsIndexingAtBuildTime()).toBe(true);
   });
 
-  it('is false when DOCS_FORCE_NOINDEX=1 even if allow indexing', () => {
+  it('is false when DOCS_ALLOW_INDEXING=1 (rejects non-true values)', () => {
     vi.stubEnv('DOCS_ALLOW_INDEXING', '1');
-    vi.stubEnv('DOCS_FORCE_NOINDEX', '1');
+    expect(allowDocsIndexingAtBuildTime()).toBe(false);
+  });
+
+  it('is false when DOCS_ALLOW_INDEXING=yes (rejects non-true values)', () => {
+    vi.stubEnv('DOCS_ALLOW_INDEXING', 'yes');
+    expect(allowDocsIndexingAtBuildTime()).toBe(false);
+  });
+
+  it('is false when DOCS_ALLOW_INDEXING=false', () => {
+    vi.stubEnv('DOCS_ALLOW_INDEXING', 'false');
     expect(allowDocsIndexingAtBuildTime()).toBe(false);
   });
 });
 
 describe('docsRootMetadataRobots', () => {
   it('matches allow flag', () => {
-    vi.stubEnv('DOCS_ALLOW_INDEXING', '1');
+    vi.stubEnv('DOCS_ALLOW_INDEXING', 'true');
     expect(docsRootMetadataRobots()).toEqual({ index: true, follow: true });
   });
 
diff --git a/docs/website/tests/robots.test.ts b/docs/website/tests/robots.test.ts
new file mode 100644
index 0000000000..7aaf6e718b
--- /dev/null
+++ b/docs/website/tests/robots.test.ts
@@ -0,0 +1,112 @@
+import { describe, it, expect, afterEach, vi } from 'vitest';
+import { GET, AI_BOT_USER_AGENTS } from '@/app/robots.txt/route';
+import { DOCS_SITE_ORIGIN } from '@/lib/docs-open-graph';
+
+const CONTENT_SIGNAL_LINE =
+  'Content-Signal: ai-train=yes, search=yes, ai-input=yes';
+
+afterEach(() => {
+  vi.unstubAllEnvs();
+});
+
+async function getBody(): Promise<string> {
+  return await GET().text();
+}
+
+function countOccurrences(haystack: string, needle: string): number {
+  if (!needle.length) return 0;
+  return haystack.split(needle).length - 1;
+}
+
+describe('robots.txt route', () => {
+  describe('when DOCS_ALLOW_INDEXING=true (production)', () => {
+    it('emits Content-Signal once per User-agent block (wildcard + each AI bot)', async () => {
+      vi.stubEnv('DOCS_ALLOW_INDEXING', 'true');
+
+      const body = await getBody();
+
+      expect(countOccurrences(body, CONTENT_SIGNAL_LINE)).toBe(
+        1 + AI_BOT_USER_AGENTS.length,
+      );
+    });
+
+    it('emits a wildcard block with Content-Signal and Allow: /', async () => {
+      vi.stubEnv('DOCS_ALLOW_INDEXING', 'true');
+
+      const body = await getBody();
+
+      expect(body).toContain(
+        `User-agent: *\n${CONTENT_SIGNAL_LINE}\nAllow: /`,
+      );
+    });
+
+    it('emits an explicit block for each AI bot in order, each with Content-Signal and Allow: /', async () => {
+      vi.stubEnv('DOCS_ALLOW_INDEXING', 'true');
+
+      const body = await getBody();
+
+      let lastIndex = body.indexOf('User-agent: *');
+      expect(lastIndex).toBeGreaterThanOrEqual(0);
+
+      for (const bot of AI_BOT_USER_AGENTS) {
+        const block = `User-agent: ${bot}\n${CONTENT_SIGNAL_LINE}\nAllow: /`;
+        const idx = body.indexOf(block);
+        expect(idx, `block for ${bot} not found`).toBeGreaterThan(lastIndex);
+        lastIndex = idx;
+      }
+    });
+
+    it('terminates with a Sitemap line pointing at the canonical sitemap', async () => {
+      vi.stubEnv('DOCS_ALLOW_INDEXING', 'true');
+
+      const body = await getBody();
+
+      expect(body.endsWith(`Sitemap: ${DOCS_SITE_ORIGIN}/sitemap.xml\n`)).toBe(
+        true,
+      );
+    });
+
+    it('preserves the AI bot list and order required by RFC 9309 guidance', () => {
+      expect(AI_BOT_USER_AGENTS).toEqual([
+        'GPTBot',
+        'OAI-SearchBot',
+        'Claude-Web',
+        'Google-Extended',
+        'Amazonbot',
+        'anthropic-ai',
+        'Bytespider',
+        'CCBot',
+        'Applebot-Extended',
+      ]);
+    });
+  });
+
+  describe('when indexing is disabled (preview / PR / local)', () => {
+    it('emits exactly a wildcard Disallow body and nothing else', async () => {
+      vi.stubEnv('DOCS_ALLOW_INDEXING', '');
+
+      const body = await getBody();
+
+      expect(body).toBe('User-agent: *\nDisallow: /\n');
+    });
+
+    it('does not emit Content-Signal or Sitemap', async () => {
+      vi.stubEnv('DOCS_ALLOW_INDEXING', 'false');
+
+      const body = await getBody();
+
+      expect(body).not.toContain('Content-Signal');
+      expect(body).not.toContain('Sitemap:');
+    });
+
+    it('does not emit per-AI-bot blocks', async () => {
+      vi.stubEnv('DOCS_ALLOW_INDEXING', '');
+
+      const body = await getBody();
+
+      for (const bot of AI_BOT_USER_AGENTS) {
+        expect(body).not.toContain(`User-agent: ${bot}`);
+      }
+    });
+  });
+});