Skip to content

The Open Standard for Generative UI

docs: fix site-crawl SEO issues (H1, duplicate titles, localhost and redirecting links) (#1476)

devin-ai-integration[bot]f9ce2daa6819
diff --git a/docs/app/(home)/cloud/gateway/IntegrateSection.tsx b/docs/app/(home)/cloud/gateway/IntegrateSection.tsx
index 1028767f7..991bbedcf 100644
--- a/docs/app/(home)/cloud/gateway/IntegrateSection.tsx
+++ b/docs/app/(home)/cloud/gateway/IntegrateSection.tsx
@@ -46,7 +46,7 @@ export function IntegrateSection() {
code={GATEWAY_EXAMPLE}
highlightLines={[2, 6, 8]}
codeLabel="OpenUI Gateway client configuration"
- action={{ label: "Read integration guide", href: "/docs/openui-cloud/get-started" }}
+ action={{ label: "Read integration guide", href: "/docs/gateway/generate-openui-lang" }}
titleSize="medium"
/>
</section>
diff --git a/docs/app/(home)/sections/AutofixSection/AutofixSection.tsx b/docs/app/(home)/sections/AutofixSection/AutofixSection.tsx
index a05344322..bd45edab4 100644
--- a/docs/app/(home)/sections/AutofixSection/AutofixSection.tsx
+++ b/docs/app/(home)/sections/AutofixSection/AutofixSection.tsx
@@ -93,7 +93,7 @@ export function AutofixSection({
<BevelButton
className={styles.cta}
variant="secondary"
- href={content?.action.href ?? "/docs/gateway/api/autofix"}
+ href={content?.action.href ?? "/docs/autofix"}
label={content?.action.label ?? "View docs"}
badge={<ArrowRight size={16} weight="bold" />}
/>
@@ -105,7 +105,7 @@ export function AutofixSection({
<BevelButton
className={styles.cta}
variant="secondary"
- href={content?.action.href ?? "/docs/gateway/api/autofix"}
+ href={content?.action.href ?? "/docs/autofix"}
label={content?.action.label ?? "View docs"}
badge={<ArrowRight size={16} weight="bold" />}
/>
diff --git a/docs/app/(home)/sections/ProductSection/products.ts b/docs/app/(home)/sections/ProductSection/products.ts
index a0cedcc49..06e84a5db 100644
--- a/docs/app/(home)/sections/ProductSection/products.ts
+++ b/docs/app/(home)/sections/ProductSection/products.ts
@@ -85,7 +85,7 @@ export const OBSERVABILITY_PRODUCT: ProductSectionProps = {
headline: "Product analytics for Generative UI.",
description:
"See what your agent generated, what users experienced, and where your product needs to improve.",
- secondaryCta: { label: "View docs", href: "/docs/agent/getting-started/openui-cloud" },
+ secondaryCta: { label: "View docs", href: "/docs/agent/getting-started/quickstart" },
tone: "dark",
shot: "/homepage/observability",
fullBleedArt: true,
diff --git a/docs/app/blog/page.tsx b/docs/app/blog/page.tsx
index 0842ba9b7..b31ce147a 100644
--- a/docs/app/blog/page.tsx
+++ b/docs/app/blog/page.tsx
@@ -1,5 +1,6 @@
import { blog } from "@/lib/source";
import { ArrowUpRight, ImageIcon } from "lucide-react";
+import type { Metadata } from "next";
import Link from "next/link";
import type { ReactNode } from "react";
import { PageHero, PageHeroAccent } from "../(home)/components/PageHero/PageHero";
@@ -193,6 +194,12 @@ function RegularCard({ card }: { card: BlogCardData }) {
);
}
+export const metadata: Metadata = {
+ title: "Generative UI blog",
+ description:
+ "Articles on Generative UI from the OpenUI team: OpenUI Lang, agent interfaces, benchmarks, and building apps that respond with UI.",
+};
+
export default function BlogIndex() {
const localCards: BlogCardData[] = blog.getPages().map((post) => {
const slug = post.url.split("/").filter(Boolean).pop();
diff --git a/docs/app/chat/_components/sidebar-upgrade-sheet.tsx b/docs/app/chat/_components/sidebar-upgrade-sheet.tsx
index acac7b8ac..06f98082c 100644
--- a/docs/app/chat/_components/sidebar-upgrade-sheet.tsx
+++ b/docs/app/chat/_components/sidebar-upgrade-sheet.tsx
@@ -92,7 +92,7 @@ export function SidebarUpgradeFooter({ forkRegistry }: SidebarUpgradeFooterProps
<h2 className={styles.upgradeSheetTitle}>12 reasons to switch to Cloud</h2>
<div className={styles.upgradeSheetActions}>
<Link
- href="/docs/agent/getting-started/openui-cloud"
+ href="/docs/agent/getting-started/quickstart"
prefetch={false}
className={`${styles.upgradeSheetCta} ${styles.upgradeSheetCtaDesktop}`}
data-attribute-element="upgrade-cta"
@@ -119,7 +119,7 @@ export function SidebarUpgradeFooter({ forkRegistry }: SidebarUpgradeFooterProps
</div>
<CloudFeatureMarquee />
<Link
- href="/docs/agent/getting-started/openui-cloud"
+ href="/docs/agent/getting-started/quickstart"
prefetch={false}
className={`${styles.upgradeSheetCta} ${styles.upgradeSheetCtaMobile}`}
data-attribute-element="upgrade-cta"
diff --git a/docs/app/compare/_components/chat-page-header.tsx b/docs/app/compare/_components/chat-page-header.tsx
index 63037a3c1..95b4244a5 100644
--- a/docs/app/compare/_components/chat-page-header.tsx
+++ b/docs/app/compare/_components/chat-page-header.tsx
@@ -250,7 +250,7 @@ function ViewComparisonTray({ pair }: { pair: ComparisonPair }) {
</div>
))}
<Link
- href="/docs/agent/getting-started/openui-cloud"
+ href="/docs/agent/getting-started/quickstart"
prefetch={false}
className={styles.comparisonCta}
>
diff --git a/docs/app/debug/page.tsx b/docs/app/debug/page.tsx
index 998044a9a..5084ff206 100644
--- a/docs/app/debug/page.tsx
+++ b/docs/app/debug/page.tsx
@@ -11,5 +11,10 @@ const Playground = dynamic(() => import("./components/Playground").then((m) => m
});
export default function DebugPage() {
- return <Playground />;
+ return (
+ <>
+ <h1 className="sr-only">OpenUI Lang debug playground</h1>
+ <Playground />
+ </>
+ );
}
diff --git a/docs/app/sitemap.ts b/docs/app/sitemap.ts
index ec7376ca6..56afa20cf 100644
--- a/docs/app/sitemap.ts
+++ b/docs/app/sitemap.ts
@@ -9,7 +9,7 @@ const STATIC_PATHS = [
"/integrations",
"/chat",
"/demo/f1-dashboard",
- "/demo/trip-planner",
+ "/demo/trip-planner/planner",
"/demo/intelligent-ui",
"/demo/github",
"/pricing",
diff --git a/docs/components/docs-route-layout.tsx b/docs/components/docs-route-layout.tsx
index 0c3c095a0..d80575fa7 100644
--- a/docs/components/docs-route-layout.tsx
+++ b/docs/components/docs-route-layout.tsx
@@ -149,6 +149,8 @@ export function DocsRouteLayout({ tree, noSidebarUrls, children }: DocsRouteLayo
tree={activeTree}
{...baseOptions()}
nav={{ component: <DocsNavbar showSidebarTrigger={hasSidebar} /> }}
+ // DocsNavbar already links the logo home; the sidebar's own title link would render empty.
+ slots={{ navTitle: () => null }}
sidebar={{
enabled: hasSidebar,
tabs: false,
diff --git a/docs/content/docs/agent/getting-started/quickstart.mdx b/docs/content/docs/agent/getting-started/quickstart.mdx
index 6612b8540..5a42d93b4 100644
--- a/docs/content/docs/agent/getting-started/quickstart.mdx
+++ b/docs/content/docs/agent/getting-started/quickstart.mdx
@@ -35,7 +35,7 @@ pnpm dev
npm run dev
```
-Open [http://localhost:3000](http://localhost:3000) and request an interface such as a comparison table or interactive form.
+Open `http://localhost:3000` and request an interface such as a comparison table or interactive form.
## 3. Share a preview
diff --git a/docs/content/docs/api-reference/server.mdx b/docs/content/docs/api-reference/server.mdx
index 658e8ad38..a21eb2631 100644
--- a/docs/content/docs/api-reference/server.mdx
+++ b/docs/content/docs/api-reference/server.mdx
@@ -4,7 +4,7 @@ description: API reference for Autofix helpers and conversation history persiste
---
Server utilities for OpenUI Gateway. Validate and repair model-generated OpenUI Lang, and persist a completed turn as Conversations API items.
-Import from the subpath that matches your SDK. The helpers call [Autofix HTTP API](/docs/gateway/api/autofix).
+Import from the subpath that matches your SDK. The helpers call [Autofix HTTP API](/docs/autofix).
## Install
diff --git a/docs/content/docs/build-agents/frameworks/langgraph.mdx b/docs/content/docs/build-agents/frameworks/langgraph.mdx
index 499a3a490..892d18011 100644
--- a/docs/content/docs/build-agents/frameworks/langgraph.mdx
+++ b/docs/content/docs/build-agents/frameworks/langgraph.mdx
@@ -185,7 +185,7 @@ yarn dev
npm run dev
```
-Open [http://localhost:3000](http://localhost:3000) and try "Weather in Tokyo"
+Open `http://localhost:3000` and try "Weather in Tokyo"
or "AAPL stock price".
## Deploy to LangGraph Platform
diff --git a/docs/content/docs/build-agents/frameworks/pi.mdx b/docs/content/docs/build-agents/frameworks/pi.mdx
index 6cfe05480..cd53bf586 100644
--- a/docs/content/docs/build-agents/frameworks/pi.mdx
+++ b/docs/content/docs/build-agents/frameworks/pi.mdx
@@ -185,7 +185,7 @@ cp .env.example .env # set THESYS_API_KEY
pnpm dev -- /path/to/your/project
```
-Open [http://localhost:3000](http://localhost:3000) and try "Summarize the files in this project as a card" or "Read package.json and list its scripts". pi's tools run and the result renders as generative UI.
+Open `http://localhost:3000` and try "Summarize the files in this project as a card" or "Read package.json and list its scripts". pi's tools run and the result renders as generative UI.
## Use a different chat UI
diff --git a/docs/content/docs/build-agents/frameworks/vercel-eve.mdx b/docs/content/docs/build-agents/frameworks/vercel-eve.mdx
index 6a5d9bcd4..0257e8f91 100644
--- a/docs/content/docs/build-agents/frameworks/vercel-eve.mdx
+++ b/docs/content/docs/build-agents/frameworks/vercel-eve.mdx
@@ -217,7 +217,7 @@ cp .env.example .env
npm run dev
```
-Open [http://localhost:3000](http://localhost:3000) and start a conversation. The example requires
+Open `http://localhost:3000` and start a conversation. The example requires
`THESYS_API_KEY` and accepts an optional `OPENUI_MODEL` override. The default model is
`google/gemini-3.6-flash-free`.
diff --git a/docs/content/docs/build-agents/index.mdx b/docs/content/docs/build-agents/index.mdx
index 48450c676..82b3ee614 100644
--- a/docs/content/docs/build-agents/index.mdx
+++ b/docs/content/docs/build-agents/index.mdx
@@ -1,5 +1,6 @@
---
title: Overview
+seoTitle: Build AI agents that respond with generative UI
description: Build agents that respond with interactive interfaces made from your components.
---
diff --git a/docs/content/docs/cookbooks/booking-assistant.mdx b/docs/content/docs/cookbooks/booking-assistant.mdx
index cb6d74c64..81472c662 100644
--- a/docs/content/docs/cookbooks/booking-assistant.mdx
+++ b/docs/content/docs/cookbooks/booking-assistant.mdx
@@ -100,7 +100,7 @@ Configure `THESYS_API_KEY` from the [Thesys Console](https://console.thesys.dev/
npm run dev
```
-Open [localhost:3000](http://localhost:3000) and try a starter. A search takes about ten seconds, most of it on trivago's side. The default model is `openai/gpt-5.5`; use `OPENUI_MODEL` to select another supported [Gateway model](/docs/gateway/models).
+Open `http://localhost:3000` and try a starter. A search takes about ten seconds, most of it on trivago's side. The default model is `openai/gpt-5.5`; use `OPENUI_MODEL` to select another supported [Gateway model](/docs/gateway/models).
## Build it step by step
diff --git a/docs/content/docs/cookbooks/conversational-analytics.mdx b/docs/content/docs/cookbooks/conversational-analytics.mdx
index ad362b455..86aef772f 100644
--- a/docs/content/docs/cookbooks/conversational-analytics.mdx
+++ b/docs/content/docs/cookbooks/conversational-analytics.mdx
@@ -92,7 +92,7 @@ Create an inference key in the [Thesys Console](https://console.thesys.dev/keys)
npm run dev
```
-Open [localhost:3000](http://localhost:3000) and try a starter question. The default model is `openai/gpt-5.5`; use `OPENUI_MODEL` to select another supported [Gateway model](/docs/gateway/models).
+Open `http://localhost:3000` and try a starter question. The default model is `openai/gpt-5.5`; use `OPENUI_MODEL` to select another supported [Gateway model](/docs/gateway/models).
## Build it step by step
diff --git a/docs/content/docs/cookbooks/document-comparison.mdx b/docs/content/docs/cookbooks/document-comparison.mdx
index 3e64f050e..c086bbf80 100644
--- a/docs/content/docs/cookbooks/document-comparison.mdx
+++ b/docs/content/docs/cookbooks/document-comparison.mdx
@@ -105,7 +105,7 @@ npm run prepare:documents
npm run dev
```
-The first run downloads about 83 MB of PDFs, which later runs reuse, and embeds 1,564 passages for about a cent. Open [localhost:3000](http://localhost:3000) and try a starter question. The default model is `openai/gpt-5.5`; use `OPENUI_MODEL` to select another supported [Gateway model](/docs/gateway/models).
+The first run downloads about 83 MB of PDFs, which later runs reuse, and embeds 1,564 passages for about a cent. Open `http://localhost:3000` and try a starter question. The default model is `openai/gpt-5.5`; use `OPENUI_MODEL` to select another supported [Gateway model](/docs/gateway/models).
## Build it step by step
diff --git a/docs/content/docs/gateway/api/chat-completions.mdx b/docs/content/docs/gateway/api/chat-completions.mdx
index 418f5000f..ca6172e03 100644
--- a/docs/content/docs/gateway/api/chat-completions.mdx
+++ b/docs/content/docs/gateway/api/chat-completions.mdx
@@ -7,7 +7,7 @@ Gateway provides OpenAI compatible Chat Completions API endpoints, letting you u
The Chat Completions API implements the same specification as the [**OpenAI Chat Completions API**](https://platform.openai.com/docs/api-reference/chat).
-**Endpoint:** POST [https://api.thesys.dev/v1/embed/chat/completions](https://api.thesys.dev/v1/embed/chat/completions)
+**Endpoint:** `POST https://api.thesys.dev/v1/embed/chat/completions`
## Configure the client
diff --git a/docs/content/docs/gateway/api/responses/index.mdx b/docs/content/docs/gateway/api/responses/index.mdx
index 0301d43b3..27f7b93dc 100644
--- a/docs/content/docs/gateway/api/responses/index.mdx
+++ b/docs/content/docs/gateway/api/responses/index.mdx
@@ -7,7 +7,7 @@ Gateway provides OpenAI-compatible Responses API endpoints, letting you use mult
The Responses API implements the same specification as the [**OpenAI Responses API**](https://platform.openai.com/docs/api-reference/responses).
-**Endpoint:** POST [https://api.thesys.dev/v1/embed/responses](https://api.thesys.dev/v1/embed/responses)
+**Endpoint:** `POST https://api.thesys.dev/v1/embed/responses`
## Configure the client
diff --git a/docs/content/docs/gateway/reliability.mdx b/docs/content/docs/gateway/reliability.mdx
index d2d7fadae..0b5e849a2 100644
--- a/docs/content/docs/gateway/reliability.mdx
+++ b/docs/content/docs/gateway/reliability.mdx
@@ -1,5 +1,6 @@
---
title: Reliability
+seoTitle: Model fallbacks and Autofix for LLM requests
description: Keep model requests working when providers are unavailable or models return invalid OpenUI Lang.
---
diff --git a/docs/content/docs/integrations/index.mdx b/docs/content/docs/integrations/index.mdx
index c5eb5445d..22a266786 100644
--- a/docs/content/docs/integrations/index.mdx
+++ b/docs/content/docs/integrations/index.mdx
@@ -1,5 +1,6 @@
---
title: Integrations
+seoTitle: OpenUI example apps by framework
description: Example apps that connect OpenUI to agent frameworks, app frameworks, design systems, and harnesses.
sidebar: false
pageActions: false
diff --git a/docs/content/docs/openui-lang/overview.mdx b/docs/content/docs/openui-lang/overview.mdx
index 952a55945..c17eb5f0a 100644
--- a/docs/content/docs/openui-lang/overview.mdx
+++ b/docs/content/docs/openui-lang/overview.mdx
@@ -1,5 +1,6 @@
---
title: Overview
+seoTitle: What is OpenUI Lang? Stream UI from LLM output
description: Understand the language, prompt, parser, and renderer that turn model output into application UI.
---
diff --git a/docs/content/docs/openui-lang/reliability.mdx b/docs/content/docs/openui-lang/reliability.mdx
index 68e1696eb..98ba6d333 100644
--- a/docs/content/docs/openui-lang/reliability.mdx
+++ b/docs/content/docs/openui-lang/reliability.mdx
@@ -1,5 +1,6 @@
---
title: Reliability
+seoTitle: Fix and prevent errors in LLM-generated UI
description: Build reliable LLM-generated interfaces by measuring, reducing, and correcting generation errors.
---
diff --git a/docs/content/docs/production.mdx b/docs/content/docs/production.mdx
index 2908e2e24..9d26896a0 100644
--- a/docs/content/docs/production.mdx
+++ b/docs/content/docs/production.mdx
@@ -68,7 +68,7 @@ Integrate OpenUI Gateway with your existing backend stack, including LangGraph,
</Tab>
</Tabs>
-Learn more about OpenUI Gateway [here](/docs/gateway).
+Learn more in the [OpenUI Gateway docs](/docs/gateway).
## Autofix
diff --git a/docs/lib/docs-navigation.ts b/docs/lib/docs-navigation.ts
index 91a60fa72..58d332033 100644
--- a/docs/lib/docs-navigation.ts
+++ b/docs/lib/docs-navigation.ts
@@ -63,6 +63,8 @@ export const NESTED_DOCS_SECTIONS: Record<NestedDocsRoot, NestedSection> = {
export const API_REFERENCE_URL = "/docs/api-reference";
export const COOKBOOKS_URL = "/cookbooks";
+// The Cookbooks overview is temporarily removed and /cookbooks redirects here; link to it directly.
+export const COOKBOOKS_ENTRY_URL = "/cookbooks/conversational-analytics";
export const INTEGRATIONS_URL = "/docs/integrations";
export const DEMOS_URL = "/demos";
@@ -101,7 +103,7 @@ export const GLOBAL_DOCS_TREE: PageTree.Root = {
name: NESTED_DOCS_SECTIONS["build-agents"].title,
url: NESTED_DOCS_SECTIONS["build-agents"].entryUrl,
},
- { type: "page", name: "Cookbooks", url: COOKBOOKS_URL },
+ { type: "page", name: "Cookbooks", url: COOKBOOKS_ENTRY_URL },
{ type: "separator", name: "Production" },
{ type: "page", name: "Overview", url: "/docs/production" },
{
diff --git a/docs/lib/lab-projects.ts b/docs/lib/lab-projects.ts
index 4840f9c01..cc5d14fdf 100644
--- a/docs/lib/lab-projects.ts
+++ b/docs/lib/lab-projects.ts
@@ -251,7 +251,7 @@ export const labProjects: ProjectItem[] = [
},
{
label: "Docs",
- href: "/docs/openui-lang/examples/app-frameworks/react-native",
+ href: "/integrations/react-native",
external: true,
},
],
diff --git a/docs/lib/site-nav-links.ts b/docs/lib/site-nav-links.ts
index 2b0c5770d..3214be94b 100644
--- a/docs/lib/site-nav-links.ts
+++ b/docs/lib/site-nav-links.ts
@@ -5,7 +5,7 @@ export const SITE_NAV_LINKS = {
gateway: { href: "/cloud/gateway" },
observability: { href: "/cloud/observability" },
gettingStarted: { href: "/docs/getting-started" },
- cookbooks: { href: "/cookbooks" },
+ cookbooks: { href: "/cookbooks/conversational-analytics" },
apiReference: { href: "/docs/api-reference" },
demos: { href: "/demos", newTab: false },
documentation: { href: "/docs", newTab: false },