From 64de82985bfa8d365759f4c5db843a8482043791 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=98=D0=BB=D0=B8=D1=8F?= <iliyazelenkog@gmail.com>
Date: Sun, 31 May 2026 15:30:33 +0300
Subject: [PATCH] fix(landing): point docs links to render docs site (#197)

---
 landing/README.md                           |  3 ++-
 landing/components/layout/AppFooter.vue     | 13 +++++----
 landing/components/layout/AppHeader.vue     | 11 +++++---
 landing/components/sections/HeroSection.vue | 11 +++++---
 landing/nuxt.config.ts                      |  2 ++
 landing/public/docs/index.html              | 12 +++++++++
 landing/public/docs/ru/index.html           | 12 +++++++++
 landing/server/routes/llms.txt.ts           |  6 +++--
 landing/server/routes/robots.txt.ts         |  5 +++-
 landing/utils/docsUrl.ts                    | 29 +++++++++++++++++++++
 10 files changed, 89 insertions(+), 15 deletions(-)
 create mode 100644 landing/public/docs/index.html
 create mode 100644 landing/public/docs/ru/index.html
 create mode 100644 landing/utils/docsUrl.ts

diff --git a/landing/README.md b/landing/README.md
index 7e21d2be..566c0b0f 100644
--- a/landing/README.md
+++ b/landing/README.md
@@ -21,7 +21,7 @@ Landing and docs are deployed as separate Render Static Sites from the `main` br
 Landing:
 
 ```bash
-corepack enable && pnpm install --frozen-lockfile --ignore-scripts && NUXT_PUBLIC_SITE_URL=$RENDER_EXTERNAL_URL NUXT_PUBLIC_ROBOTS="index, follow" pnpm --filter agent-teams-landing generate
+corepack enable && pnpm install --frozen-lockfile --ignore-scripts && NUXT_PUBLIC_SITE_URL=$RENDER_EXTERNAL_URL NUXT_PUBLIC_DOCS_SITE_URL=https://agent-teams-ai-docs.onrender.com NUXT_PUBLIC_ROBOTS="index, follow" pnpm --filter agent-teams-landing generate
 ```
 
 Publish path: `landing/.output/public`
@@ -45,3 +45,4 @@ When a custom landing domain is attached, update `VITEPRESS_LANDING_SITE_URL` on
 - Theme auto-detection: localStorage -> system preference -> fallback `light`.
 - Hero video uses the Mux Player embed. Set `NUXT_PUBLIC_MUX_PLAYBACK_ID` to override the default playback id without changing the code.
 - Hero background can use a separate Mux asset via `NUXT_PUBLIC_MUX_BACKGROUND_PLAYBACK_ID`; otherwise it reuses `NUXT_PUBLIC_MUX_PLAYBACK_ID`.
+- Set `NUXT_PUBLIC_DOCS_SITE_URL` when the docs are deployed as a separate static site.
diff --git a/landing/components/layout/AppFooter.vue b/landing/components/layout/AppFooter.vue
index 52be6429..e5a8b025 100644
--- a/landing/components/layout/AppFooter.vue
+++ b/landing/components/layout/AppFooter.vue
@@ -1,15 +1,18 @@
 <script setup lang="ts">
 import robotLeadLounge from "~/assets/images/footer/robot-lead-lounge-v1.webp";
+import { buildDocsHref } from "~/utils/docsUrl";
 
 const { t, locale } = useI18n();
 const { repoUrl } = useGithubRepo();
-const { baseURL } = useRuntimeConfig().app;
+const runtimeConfig = useRuntimeConfig();
+const { baseURL } = runtimeConfig.app;
 const year = new Date().getFullYear();
 const authorLabel = computed(() => locale.value === 'ru' ? 'Автор' : 'Author');
-const docsHref = computed(() => {
-  const base = baseURL.replace(/\/?$/, '/');
-  return `${base}${locale.value === 'ru' ? 'docs/ru/' : 'docs/'}`;
-});
+const docsHref = computed(() => buildDocsHref({
+  locale: locale.value,
+  docsSiteUrl: runtimeConfig.public.docsSiteUrl,
+  embeddedBaseURL: baseURL,
+}));
 </script>
 
 <template>
diff --git a/landing/components/layout/AppHeader.vue b/landing/components/layout/AppHeader.vue
index eaebcabf..301bfe86 100644
--- a/landing/components/layout/AppHeader.vue
+++ b/landing/components/layout/AppHeader.vue
@@ -1,13 +1,18 @@
 <script setup lang="ts">
 import { mdiMenu, mdiClose, mdiGithub } from '@mdi/js';
+import { buildDocsHref } from '~/utils/docsUrl';
 
 const { t, locale } = useI18n();
 const { repoUrl } = useGithubRepo();
-const { baseURL } = useRuntimeConfig().app;
+const runtimeConfig = useRuntimeConfig();
+const { baseURL } = runtimeConfig.app;
 const menuOpen = ref(false);
 
-const withBase = (path: string) => `${baseURL.replace(/\/?$/, '/')}${path.replace(/^\/+/, '')}`;
-const docsHref = computed(() => withBase(locale.value === 'ru' ? 'docs/ru/' : 'docs/'));
+const docsHref = computed(() => buildDocsHref({
+  locale: locale.value,
+  docsSiteUrl: runtimeConfig.public.docsSiteUrl,
+  embeddedBaseURL: baseURL,
+}));
 const isRu = computed(() => locale.value === 'ru');
 const openMenuLabel = computed(() => (isRu.value ? 'Открыть меню' : 'Open menu'));
 const closeMenuLabel = computed(() => (isRu.value ? 'Закрыть меню' : 'Close menu'));
diff --git a/landing/components/sections/HeroSection.vue b/landing/components/sections/HeroSection.vue
index b7877ff4..55f61b77 100644
--- a/landing/components/sections/HeroSection.vue
+++ b/landing/components/sections/HeroSection.vue
@@ -4,10 +4,12 @@ import {
   mdiDownload,
 } from "@mdi/js";
 import { getLocalizedHeroMessages, type HeroMessagePhase } from "~/data/heroScene";
+import { buildDocsHref } from "~/utils/docsUrl";
 
 const { content } = useLandingContent();
 const { t, locale } = useI18n();
-const { baseURL } = useRuntimeConfig().app;
+const runtimeConfig = useRuntimeConfig();
+const { baseURL } = runtimeConfig.app;
 const heroRef = ref<HTMLElement | null>(null);
 const activeHeroMessageIndex = ref(0);
 const heroMessagePhase = ref<HeroMessagePhase>("cooldown");
@@ -21,7 +23,6 @@ const downloadStore = useDownloadStore();
 const { resolve, data: releaseData } = useReleaseDownloads();
 const { latestReleaseUrl, releaseDownloadUrl } = useGithubRepo();
 const { selectedDownloadAsset } = useDownloadAssetPresentation();
-const withBase = (path: string) => `${baseURL.replace(/\/?$/, "/")}${path.replace(/^\/+/, "")}`;
 
 useCyberHeroParallax(heroRef);
 
@@ -71,7 +72,11 @@ const heroDownloadUrl = computed(() => {
   return resolve(asset.os, arch)?.url || releaseDownloadUrl(asset.fileName);
 });
 
-const docsHref = computed(() => withBase(locale.value === "ru" ? "docs/ru/" : "docs/"));
+const docsHref = computed(() => buildDocsHref({
+  locale: locale.value,
+  docsSiteUrl: runtimeConfig.public.docsSiteUrl,
+  embeddedBaseURL: baseURL,
+}));
 const downloadActionSubtitle = computed(() => {
   if (!selectedDownloadAsset.value) {
     return locale.value === "ru"
diff --git a/landing/nuxt.config.ts b/landing/nuxt.config.ts
index 2b23c57b..623b68e9 100644
--- a/landing/nuxt.config.ts
+++ b/landing/nuxt.config.ts
@@ -12,6 +12,7 @@ const githubRepo = process.env.NUXT_PUBLIC_GITHUB_REPO || "777genius/agent-teams
 const githubReleasesUrl = `https://github.com/${githubRepo}/releases`;
 const muxPlaybackId = process.env.NUXT_PUBLIC_MUX_PLAYBACK_ID || "qyeNuDjFqoDALK8eB02jMTOWUz006BdIhiqiAip3U00x7I";
 const muxBackgroundPlaybackId = process.env.NUXT_PUBLIC_MUX_BACKGROUND_PLAYBACK_ID || muxPlaybackId;
+const docsSiteUrl = process.env.NUXT_PUBLIC_DOCS_SITE_URL || "";
 const baseURL = process.env.NUXT_APP_BASE_URL || "/";
 const basePrefixedDocsPath = `${baseURL.replace(/\/?$/, "/")}docs`;
 const repoRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
@@ -144,6 +145,7 @@ export default defineNuxtConfig({
       siteUrl,
       githubRepo,
       githubReleasesUrl,
+      docsSiteUrl,
       muxPlaybackId,
       muxBackgroundPlaybackId
     }
diff --git a/landing/public/docs/index.html b/landing/public/docs/index.html
new file mode 100644
index 00000000..9cf7ee07
--- /dev/null
+++ b/landing/public/docs/index.html
@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <meta http-equiv="refresh" content="0; url=https://agent-teams-ai-docs.onrender.com/">
+    <link rel="canonical" href="https://agent-teams-ai-docs.onrender.com/">
+    <title>Redirecting to Agent Teams Docs</title>
+  </head>
+  <body>
+    <a href="https://agent-teams-ai-docs.onrender.com/">Agent Teams Docs</a>
+  </body>
+</html>
diff --git a/landing/public/docs/ru/index.html b/landing/public/docs/ru/index.html
new file mode 100644
index 00000000..c2d0514d
--- /dev/null
+++ b/landing/public/docs/ru/index.html
@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="ru">
+  <head>
+    <meta charset="utf-8">
+    <meta http-equiv="refresh" content="0; url=https://agent-teams-ai-docs.onrender.com/ru/">
+    <link rel="canonical" href="https://agent-teams-ai-docs.onrender.com/ru/">
+    <title>Redirecting to Agent Teams Docs</title>
+  </head>
+  <body>
+    <a href="https://agent-teams-ai-docs.onrender.com/ru/">Agent Teams Docs</a>
+  </body>
+</html>
diff --git a/landing/server/routes/llms.txt.ts b/landing/server/routes/llms.txt.ts
index 93b8268d..1c43f160 100644
--- a/landing/server/routes/llms.txt.ts
+++ b/landing/server/routes/llms.txt.ts
@@ -1,4 +1,5 @@
 import { defaultLocale, getLocalizedPagePath, sitemapPages, supportedLocales } from "~/data/i18n";
+import { normalizeDocsSiteUrl } from "~/utils/docsUrl";
 
 const trimTrailingSlash = (value: string) => value.replace(/\/+$/, "");
 
@@ -11,6 +12,7 @@ export default defineEventHandler((event) => {
   const githubUrl = `https://github.com/${githubRepo}`;
   const releasesUrl = `${githubUrl}/releases`;
   const toSiteUrl = (path: string) => `${siteUrl}${path === "/" ? "/" : `/${path.replace(/^\/+/, "")}`}`;
+  const docsSiteUrl = normalizeDocsSiteUrl(config.public.docsSiteUrl) || toSiteUrl("/docs/");
 
   setHeader(event, "content-type", "text/plain; charset=utf-8");
 
@@ -32,8 +34,8 @@ export default defineEventHandler((event) => {
 
 - Homepage (${defaultLocale}): ${toSiteUrl("/")}
 - Download: ${toSiteUrl("/download")}
-- Documentation: ${toSiteUrl("/docs/")}
-- Documentation llms.txt: ${toSiteUrl("/docs/llms.txt")}
+- Documentation: ${docsSiteUrl}
+- Documentation llms.txt: ${docsSiteUrl}llms.txt
 - GitHub repository: ${githubUrl}
 - Releases: ${releasesUrl}
 - Sitemap: ${toSiteUrl("/sitemap.xml")}
diff --git a/landing/server/routes/robots.txt.ts b/landing/server/routes/robots.txt.ts
index 71180757..ca59055e 100644
--- a/landing/server/routes/robots.txt.ts
+++ b/landing/server/routes/robots.txt.ts
@@ -1,12 +1,15 @@
+import { normalizeDocsSiteUrl } from "~/utils/docsUrl";
+
 export default defineEventHandler((event) => {
   const config = useRuntimeConfig();
   const siteUrl = ((config.public.siteUrl as string) || "https://777genius.github.io/agent-teams-ai").replace(/\/+$/, "");
+  const docsSiteUrl = normalizeDocsSiteUrl(config.public.docsSiteUrl) || `${siteUrl}/docs/`;
 
   setHeader(event, "content-type", "text/plain; charset=utf-8");
 
   return `User-agent: *
 Allow: /
 Sitemap: ${siteUrl}/sitemap.xml
-Sitemap: ${siteUrl}/docs/sitemap.xml
+Sitemap: ${docsSiteUrl}sitemap.xml
 `;
 });
diff --git a/landing/utils/docsUrl.ts b/landing/utils/docsUrl.ts
new file mode 100644
index 00000000..db0796b7
--- /dev/null
+++ b/landing/utils/docsUrl.ts
@@ -0,0 +1,29 @@
+type DocsLocale = string | undefined;
+
+const trimTrailingSlash = (value: string) => value.replace(/\/+$/, '');
+const withTrailingSlash = (value: string) => `${trimTrailingSlash(value)}/`;
+
+export function normalizeDocsSiteUrl(value: unknown): string | null {
+  if (typeof value !== 'string') return null;
+
+  const trimmed = value.trim();
+  if (!trimmed) return null;
+
+  return withTrailingSlash(trimmed);
+}
+
+export function buildDocsHref(args: {
+  locale?: DocsLocale;
+  docsSiteUrl?: unknown;
+  embeddedBaseURL: string;
+}): string {
+  const localizedPath = args.locale === 'ru' ? 'ru/' : '';
+  const externalDocsUrl = normalizeDocsSiteUrl(args.docsSiteUrl);
+
+  if (externalDocsUrl) {
+    return `${externalDocsUrl}${localizedPath}`;
+  }
+
+  const base = args.embeddedBaseURL.replace(/\/?$/, '/');
+  return `${base}${args.locale === 'ru' ? 'docs/ru/' : 'docs/'}`;
+}