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.tsxindex 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.tsxindex 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({<BevelButtonclassName={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({<BevelButtonclassName={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.tsindex 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.tsxindex 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.tsxindex 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.tsxindex 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.tsxindex 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.tsindex 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.tsxindex 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 }: DocsRouteLayotree={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.mdxindex 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 devnpm 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 previewdiff --git a/docs/content/docs/api-reference/server.mdx b/docs/content/docs/api-reference/server.mdxindex 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).## Installdiff --git a/docs/content/docs/build-agents/frameworks/langgraph.mdx b/docs/content/docs/build-agents/frameworks/langgraph.mdxindex 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 devnpm 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 Platformdiff --git a/docs/content/docs/build-agents/frameworks/pi.mdx b/docs/content/docs/build-agents/frameworks/pi.mdxindex 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_KEYpnpm 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 UIdiff --git a/docs/content/docs/build-agents/frameworks/vercel-eve.mdx b/docs/content/docs/build-agents/frameworks/vercel-eve.mdxindex 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 .envnpm 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.mdxindex 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 UIdescription: 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.mdxindex 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 stepdiff --git a/docs/content/docs/cookbooks/conversational-analytics.mdx b/docs/content/docs/cookbooks/conversational-analytics.mdxindex 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 stepdiff --git a/docs/content/docs/cookbooks/document-comparison.mdx b/docs/content/docs/cookbooks/document-comparison.mdxindex 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:documentsnpm 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 stepdiff --git a/docs/content/docs/gateway/api/chat-completions.mdx b/docs/content/docs/gateway/api/chat-completions.mdxindex 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 uThe 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 clientdiff --git a/docs/content/docs/gateway/api/responses/index.mdx b/docs/content/docs/gateway/api/responses/index.mdxindex 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 multThe 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 clientdiff --git a/docs/content/docs/gateway/reliability.mdx b/docs/content/docs/gateway/reliability.mdxindex 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 requestsdescription: 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.mdxindex 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 frameworkdescription: Example apps that connect OpenUI to agent frameworks, app frameworks, design systems, and harnesses.sidebar: falsepageActions: falsediff --git a/docs/content/docs/openui-lang/overview.mdx b/docs/content/docs/openui-lang/overview.mdxindex 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 outputdescription: 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.mdxindex 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 UIdescription: 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.mdxindex 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).## Autofixdiff --git a/docs/lib/docs-navigation.ts b/docs/lib/docs-navigation.tsindex 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.tsindex 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.tsindex 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 },