Skip to content

The Open Standard for Generative UI

docs: search-intent titles, meta descriptions and docs links for blog, benchmark, comparison and integration pages (#1357)

devin-ai-integration[bot]38df23076f6c
diff --git a/docs/app/(home)/benchmarks/page.tsx b/docs/app/(home)/benchmarks/page.tsx
index 8e1b84b80..06f762078 100644
--- a/docs/app/(home)/benchmarks/page.tsx
+++ b/docs/app/(home)/benchmarks/page.tsx
@@ -8,6 +8,9 @@ import {
} from "@/lib/benchmark-agent-data";
import {
BENCHMARK_VERSION,
+ blankScreens,
+ COST_MODELS,
+ costPerPass,
LINKS,
MODEL_BOARD_SIZE,
RUNS_PER_FORMAT,
@@ -21,9 +24,16 @@ const { outputPerScreen } = tokens;
const fewerTokensThan = (json: number) => Math.round((1 - outputPerScreen.openui / json) * 100);
const TOKEN_ANSWER = `Use a compact UI language instead of JSON. Across ${RUNS_PER_FORMAT.toLocaleString("en-US")} runs per format on the same 46 interfaces, OpenUI Lang averaged ${outputPerScreen.openui.toLocaleString("en-US")} output tokens per screen, versus ${outputPerScreen.jsonRender.toLocaleString("en-US")} for json-render and ${outputPerScreen.a2ui.toLocaleString("en-US")} for A2UI, both JSON formats. That is ${fewerTokensThan(outputPerScreen.jsonRender)}% and ${fewerTokensThan(outputPerScreen.a2ui)}% fewer tokens, which lowers cost and shortens streaming time.`;
+const costRatios = COST_MODELS.flatMap((model) =>
+ (["a2ui", "jsonRender"] as const).map(
+ (format) => costPerPass[model]![format] / costPerPass[model]!.openui,
+ ),
+);
+const INTRO = `We generated the same 46 interfaces with 6 models in 3 generative UI formats: OpenUI, A2UI and json-render. OpenUI had the fewest blank screens (${blankScreens.openui} in ${RUNS_PER_FORMAT.toLocaleString("en-US")} runs), used about half the tokens, and cost ${Math.min(...costRatios).toFixed(1)} to ${Math.max(...costRatios).toFixed(1)}× less on every priced model.`;
+
export const metadata: Metadata = {
- title: "Generative UI Benchmark: JSON vs OpenUI Lang token usage",
- description: `We generated the same 46 interfaces with 6 models and 3 UI formats. OpenUI produced the fewest blank screens, used the fewest tokens, and cost the least on every priced model.`,
+ title: { absolute: "Generative UI benchmark: OpenUI vs A2UI vs json-render | OpenUI" },
+ description: INTRO,
alternates: {
canonical: "/benchmarks",
types: {
@@ -37,13 +47,13 @@ export const metadata: Metadata = {
type: "article",
url: "/benchmarks",
title: "Generative UI Benchmark | OpenUI",
- description: `OpenUI results across ${MODEL_BOARD_SIZE} models, plus a six-model comparison across OpenUI, A2UI and json-render.`,
+ description: INTRO,
modifiedTime: MODEL_BOARD_UPDATED_ISO,
},
twitter: {
card: "summary_large_image",
title: "Generative UI Benchmark | OpenUI",
- description: `OpenUI results across ${MODEL_BOARD_SIZE} models, plus a six-model comparison across OpenUI, A2UI and json-render.`,
+ description: INTRO,
},
};
diff --git a/docs/app/(home)/integrations/[slug]/page.tsx b/docs/app/(home)/integrations/[slug]/page.tsx
index af46fa732..f04c66840 100644
--- a/docs/app/(home)/integrations/[slug]/page.tsx
+++ b/docs/app/(home)/integrations/[slug]/page.tsx
@@ -27,7 +27,7 @@ export async function generateMetadata(props: {
if (!integration) notFound();
return {
- title: `${integration.name} integration`,
+ title: { absolute: `${integration.seoTitle} | OpenUI` },
description: integration.summary,
alternates: { canonical: `/integrations/${integration.slug}` },
openGraph: {
diff --git a/docs/app/(home)/integrations/data.ts b/docs/app/(home)/integrations/data.ts
index 75180d09b..02d2eb7a0 100644
--- a/docs/app/(home)/integrations/data.ts
+++ b/docs/app/(home)/integrations/data.ts
@@ -14,6 +14,8 @@ export interface IntegrationStep {
export interface Integration {
slug: string;
name: string;
+ /** Search title for <title>; the H1 keeps `name`. */
+ seoTitle: string;
logo: string;
category: IntegrationCategoryId;
type: string;
@@ -84,11 +86,12 @@ const integrationCatalog: Integration[] = [
{
slug: "shadcn-ui",
name: "shadcn/ui",
+ seoTitle: "shadcn/ui generative UI: let LLMs render your shadcn components",
logo: "/integration-logos/shadcn-ui.svg",
category: "design-systems",
type: "Design system",
summary:
- "Wrap shadcn/ui components in an OpenUI library and let the model compose them as streaming interfaces.",
+ "To add generative UI to shadcn/ui, wrap your shadcn/ui components in an OpenUI library and let the model compose them as streaming interfaces.",
howItWorks:
"Each shadcn component is registered with defineComponent and a Zod prop schema. createLibrary produces both the prompt vocabulary and the renderer mapping used by the example chat app.",
steps: [
@@ -121,11 +124,12 @@ const integrationCatalog: Integration[] = [
{
slug: "material-ui",
name: "Material UI",
+ seoTitle: "Material UI (MUI) generative UI with OpenUI",
logo: "/integration-logos/mui.svg",
category: "design-systems",
type: "Design system",
summary:
- "Expose Material UI components to a model without replacing your existing React design system.",
+ "To add generative UI to Material UI, expose your Material UI components to a model through OpenUI without replacing your existing React design system.",
howItWorks:
"The example wraps Material UI components with OpenUI definitions, generates a constrained component prompt, and renders model output back into the same Material UI primitives.",
steps: [
@@ -158,11 +162,12 @@ const integrationCatalog: Integration[] = [
{
slug: "handsontable",
name: "Handsontable",
+ seoTitle: "Handsontable generative UI with OpenUI",
logo: "https://raw.githubusercontent.com/handsontable/handsontable/develop/docs/public/favicon.png",
category: "design-systems",
type: "Data grid",
summary:
- "Connect a live Handsontable spreadsheet to OpenUI so agent tools can analyze and update its data.",
+ "To add generative UI to Handsontable, connect a live Handsontable spreadsheet to OpenUI so agent tools can analyze and update its data.",
howItWorks:
"The maintained example shares table state between Handsontable and a custom OpenUI SpreadsheetTable component. Tool calls update the server-side data, and the rendered component synchronizes those results back into the live grid.",
steps: [
@@ -190,11 +195,12 @@ const integrationCatalog: Integration[] = [
{
slug: "react-email",
name: "React Email",
+ seoTitle: "Generate React Email templates with an LLM",
logo: "/integration-logos/react-email.svg",
category: "design-systems",
type: "Email component library",
summary:
- "Generate, preview, and export email-safe interfaces with OpenUI's React Email component package.",
+ "To generate React Email templates with an LLM, use OpenUI's React Email component package to generate, preview, and export email-safe interfaces.",
howItWorks:
"@openuidev/react-email provides 44 OpenUI component definitions, an emailLibrary, and prompt rules. OpenUI Lang streams into a React Email preview, which @react-email/render can convert to email-compatible HTML.",
install: "npm install @openuidev/react-email @openuidev/react-lang",
@@ -216,6 +222,7 @@ const integrationCatalog: Integration[] = [
},
],
links: [
+ { label: "React Email API reference", href: "/docs/api-reference/react-email", kind: "Docs" },
...packageLinks("@openuidev/react-email", "react-email", "/docs/api-reference/react-email"),
exampleLink("miscellaneous/react-email"),
{ label: "React Email", href: "https://react.email", kind: "Website" },
@@ -226,11 +233,12 @@ const integrationCatalog: Integration[] = [
{
slug: "langchain-langgraph",
name: "LangChain & LangGraph",
+ seoTitle: "LangGraph generative UI: build a frontend for LangGraph agents",
logo: "https://raw.githubusercontent.com/langchain-ai/docs/main/src/images/brand/langchain-icon.png",
category: "ai-frameworks",
type: "Agent framework adapter",
summary:
- "Connect LangChain and LangGraph to OpenUI through first-party server and stream adapters.",
+ "To give a LangGraph or LangChain agent a generative UI frontend, add the @openuidev/langchain stream transformer to your graph and render the stream with OpenUI. The agent's responses show up as interactive components instead of plain text.",
howItWorks:
"The @openuidev/langchain package transforms LangGraph protocol-v2 events into AG-UI on the server, then agUIAdapter() consumes the stream on the client. If your backend already returns native LangGraph named-event SSE, use the bundled langGraphAdapter() and langGraphMessageFormat instead.",
install: "npm install @openuidev/langchain @langchain/langgraph",
@@ -269,11 +277,12 @@ const integrationCatalog: Integration[] = [
{
slug: "vercel-ai-sdk",
name: "Vercel AI SDK",
+ seoTitle: "Vercel AI SDK generative UI with OpenUI",
logo: "/integration-logos/vercel.svg",
category: "ai-frameworks",
type: "AI SDK adapter",
summary:
- "Connect Vercel AI SDK UIMessage streams to OpenUI with OpenUI's bundled first-party adapter and message format.",
+ "To add generative UI to a Vercel AI SDK app, return the UIMessage stream from streamText() and render it with OpenUI's vercelAIAdapter(). It works with AI SDK v6 and v7 and handles text, tool calls and multi-step runs.",
howItWorks:
"Return the UIMessage SSE produced by streamText().toUIMessageStreamResponse(), then use vercelAIAdapter() with vercelAIMessageFormat on the client. OpenUI validates AI SDK v6 or v7 chunks and maps streamed text, tool inputs, tool results, multi-step lifecycles, and errors into AG-UI events.",
install: "npm install @openuidev/react-ui ai",
@@ -313,11 +322,12 @@ const integrationCatalog: Integration[] = [
{
slug: "google-adk",
name: "Google ADK",
+ seoTitle: "Google ADK agent UI: render rich interfaces with OpenUI",
logo: "/integration-logos/google.svg",
category: "ai-frameworks",
type: "Agent SDK",
summary:
- "Bridge Google ADK for TypeScript run events into OpenUI with tools and multi-turn sessions.",
+ "To give a Google ADK agent a UI, run it in a server route that maps ADK run events to AG-UI, then render the stream with OpenUI. The example uses ADK for TypeScript with tools and multi-turn sessions.",
howItWorks:
"A Google ADK Agent and FunctionTool run in a Next.js route. The route maps ADK runAsync events to AG-UI SSE, which agUIAdapter() parses on the client.",
steps: [
@@ -345,11 +355,12 @@ const integrationCatalog: Integration[] = [
{
slug: "mastra",
name: "Mastra",
+ seoTitle: "Mastra generative UI: build a frontend for Mastra agents",
logo: "/integration-logos/mastra.svg",
category: "ai-frameworks",
type: "Agent framework",
summary:
- "Connect a Mastra agent to OpenUI over AG-UI and render its streamed output as typed interfaces.",
+ "To build a UI for a Mastra agent, connect it to OpenUI over AG-UI and render its streamed output as typed interfaces.",
howItWorks:
"Mastra owns the agent and tools, the AG-UI transport serializes the run as SSE, and OpenUI's agUIAdapter drives the chat state and component renderer on the client.",
steps: [
@@ -382,11 +393,12 @@ const integrationCatalog: Integration[] = [
{
slug: "assistant-ui",
name: "assistant-ui",
+ seoTitle: "assistant-ui + OpenUI: generative UI inside assistant-ui chats",
logo: "/integration-logos/assistant-ui.svg",
category: "frontend-platforms",
type: "Chat framework",
summary:
- "Render streaming OpenUI programs as assistant-ui Tool UI while assistant-ui retains its conversation lifecycle.",
+ "To add generative UI to an assistant-ui chat, register the @openuidev/assistant-ui toolkit so the model can render cards, tables, charts and forms as Tool UI. assistant-ui keeps control of the conversation lifecycle.",
howItWorks:
"The @openuidev/assistant-ui toolkit registers display and human-input tools, generates matching model instructions, renders partial OpenUI Lang, and sends validated form actions back through assistant-ui's tool result flow.",
install: "npm install @openuidev/assistant-ui @assistant-ui/react",
@@ -408,6 +420,7 @@ const integrationCatalog: Integration[] = [
},
],
links: [
+ { label: "assistant-ui guide", href: "/docs/build-agents/assistant-ui", kind: "Docs" },
...packageLinks("@openuidev/assistant-ui", "assistant-ui"),
{
label: "assistant-ui guide",
@@ -424,11 +437,12 @@ const integrationCatalog: Integration[] = [
{
slug: "ag-ui",
name: "AG-UI",
+ seoTitle: "AG-UI frontend: render AG-UI streams as generative UI",
logo: "/integration-logos/ag-ui.svg",
category: "ai-frameworks",
type: "Agent protocol",
summary:
- "Consume standard AG-UI event streams in OpenUI chat surfaces with the built-in agUIAdapter.",
+ "OpenUI works as a frontend for AG-UI: point it at any AG-UI SSE endpoint and agUIAdapter() renders the event stream as generative UI. Lifecycle, text, tool and error events are supported.",
howItWorks:
"Point fetchLLM or a direct ChatLLM implementation at an AG-UI SSE endpoint and use agUIAdapter() as the stream adapter. OpenUI maps supported lifecycle, text, tool, and error events into its chat runtime.",
steps: [
@@ -461,11 +475,12 @@ const integrationCatalog: Integration[] = [
{
slug: "grok-build",
name: "Grok Build",
+ seoTitle: "Grok Build generative UI with OpenUI",
logo: "https://media.x.ai/v1/website/spacexai-symbol-black-transparent-6435cf42.png",
category: "ai-frameworks",
type: "Coding agent",
summary:
- "Use OpenUI as a generative UI frontend for persistent Grok Build coding-agent sessions.",
+ "To build a UI for Grok Build, use OpenUI as a generative UI frontend for persistent Grok Build coding-agent sessions.",
howItWorks:
"The maintained local harness talks to Grok Build through its official Agent Client Protocol stdio mode, injects the generated OpenUI rules, and maps reasoning, text, tools, and interactions into AG-UI events for AgentInterface. As shipped, it is an unauthenticated single-user harness and needs authentication, sandboxing, and a stricter permission policy before networked deployment.",
steps: [
@@ -493,11 +508,12 @@ const integrationCatalog: Integration[] = [
{
slug: "vercel-eve",
name: "Vercel Eve",
+ seoTitle: "Vercel Eve generative UI with OpenUI",
logo: "https://raw.githubusercontent.com/vercel/eve/main/.github/assets/eve.svg",
category: "ai-frameworks",
type: "Coding agent",
summary:
- "Connect Vercel Eve's resumable agent sessions to OpenUI while preserving Eve's native runtime.",
+ "To build a UI for Vercel Eve, connect Eve's resumable agent sessions to OpenUI while preserving Eve's native runtime.",
howItWorks:
"The maintained harness delivers turns over Eve's native session protocol, resumes its event stream from a stored cursor, and translates Eve text, tool, and failure events into AG-UI for AgentInterface. The example uses an unauthenticated local Eve channel; a deployed version must configure channel authentication and appropriate tool permissions.",
steps: [
@@ -530,11 +546,12 @@ const integrationCatalog: Integration[] = [
{
slug: "pi-coding-agent",
name: "Pi Coding Agent",
+ seoTitle: "Pi Coding Agent generative UI with OpenUI",
logo: "/integration-logos/pi.svg",
category: "ai-frameworks",
type: "Coding agent",
summary:
- "Embed the Pi coding-agent SDK behind OpenUI and render its answers, reasoning, and tool activity.",
+ "To build a UI for Pi Coding Agent, embed the Pi coding-agent SDK behind OpenUI and render its answers, reasoning, and tool activity.",
howItWorks:
"The maintained local harness embeds @earendil-works/pi-coding-agent in a Next.js route, injects the prompt generated from OpenUI's component library, and converts Pi text, reasoning, and tool events into an OpenAI-compatible stream consumed by openAIReadableStreamAdapter(). It exposes real filesystem and shell tools, so the shipped unauthenticated harness must not be exposed to a network as-is.",
steps: [
@@ -569,11 +586,12 @@ const integrationCatalog: Integration[] = [
{
slug: "open-webui",
name: "Open WebUI",
+ seoTitle: "Open WebUI generative UI: render rich interfaces in Open WebUI",
logo: "https://raw.githubusercontent.com/open-webui/open-webui/main/backend/open_webui/static/favicon-96x96.png",
category: "frontend-platforms",
type: "AI platform",
summary:
- "Render charts, forms, tables, cards, and follow-ups directly inside Open WebUI conversations.",
+ "To add generative UI to Open WebUI, install the OpenUI plugin to render charts, forms, tables, cards, and follow-ups directly inside Open WebUI conversations.",
howItWorks:
"The plugin gives the model a render_openui tool and returns a self-contained HTML response. A sandboxed iframe loads the OpenUI browser bundle and renders the generated program inline.",
steps: [
@@ -612,11 +630,12 @@ const integrationCatalog: Integration[] = [
{
slug: "lynx",
name: "Lynx",
+ seoTitle: "Lynx generative UI with OpenUI",
logo: "/integration-logos/lynx.svg",
category: "frontend-platforms",
type: "Cross-platform runtime",
summary:
- "Render streaming OpenUI Lang as cross-platform interfaces through Lynx's native rendering pipeline.",
+ "To add generative UI to Lynx, render streaming OpenUI Lang as cross-platform interfaces through Lynx's native rendering pipeline.",
howItWorks:
"@lynx-js/genui/openui incrementally parses OpenUI Lang, maps registered expressions to ReactLynx components, and renders them through Lynx's native pipeline while the host application owns its component definitions, tools, and actions.",
install: "npm install @lynx-js/genui @lynx-js/react @lynx-js/lynx-ui",
@@ -659,11 +678,12 @@ const integrationCatalog: Integration[] = [
{
slug: "vue",
name: "Vue 3",
+ seoTitle: "Generative UI for Vue",
logo: "/integration-logos/vue.svg",
category: "frontend-platforms",
type: "Native runtime",
summary:
- "Define model-renderable Vue components and render streamed OpenUI Lang with @openuidev/vue-lang.",
+ "To build generative UI in Vue, define your components with Zod schemas and render streamed OpenUI Lang with @openuidev/vue-lang. The UI updates progressively as the model's output arrives.",
howItWorks:
"Vue component definitions and Zod schemas form a shared library for prompt generation and rendering. The Vue Renderer updates progressively as OpenUI Lang arrives.",
install: "npm install @openuidev/vue-lang",
@@ -685,6 +705,7 @@ const integrationCatalog: Integration[] = [
},
],
links: [
+ { label: "Vue Lang API reference", href: "/docs/api-reference/vue-lang", kind: "Docs" },
...packageLinks("@openuidev/vue-lang", "vue-lang"),
exampleLink("app-frameworks/vue"),
{ label: "Vue", href: "https://vuejs.org", kind: "Website" },
@@ -693,11 +714,12 @@ const integrationCatalog: Integration[] = [
{
slug: "angular",
name: "Angular",
+ seoTitle: "Generative UI for Angular",
logo: "/integration-logos/angular.svg",
category: "frontend-platforms",
type: "Native runtime",
summary:
- "Define model-renderable Angular components and render streamed OpenUI Lang with @openuidev/angular-lang.",
+ "To build generative UI in Angular, define your components with Zod schemas and render streamed OpenUI Lang with @openuidev/angular-lang. The UI updates progressively as the model's output arrives.",
howItWorks:
"Standalone Angular components and Zod schemas form one library for prompt generation and rendering. The openui-renderer component resolves streamed statements into those components, and injection helpers give them access to actions, form state, and query loading.",
install: "npm install @openuidev/angular-lang zod rxjs",
@@ -719,6 +741,11 @@ const integrationCatalog: Integration[] = [
},
],
links: [
+ {
+ label: "Angular Lang API reference",
+ href: "/docs/api-reference/angular-lang",
+ kind: "Docs",
+ },
...packageLinks(
"@openuidev/angular-lang",
"angular-lang",
@@ -731,11 +758,12 @@ const integrationCatalog: Integration[] = [
{
slug: "react-native",
name: "React Native",
+ seoTitle: "Generative UI for React Native",
logo: "/integration-logos/react.svg",
category: "frontend-platforms",
type: "Mobile framework",
summary:
- "Render model-generated interfaces in a native mobile chat application with a dedicated component library.",
+ "To add generative UI to a React Native app, render model-generated interfaces in a native mobile chat application with a dedicated component library.",
howItWorks:
"The reference project pairs a React Native chat app with a backend that prompts for OpenUI Lang. Native component definitions map the same structured response model to mobile views and actions.",
steps: [
@@ -763,11 +791,12 @@ const integrationCatalog: Integration[] = [
{
slug: "svelte",
name: "Svelte 5",
+ seoTitle: "Generative UI for Svelte",
logo: "/integration-logos/svelte.svg",
category: "frontend-platforms",
type: "Native runtime",
summary:
- "Define Svelte components, generate prompts, and render streamed OpenUI Lang with @openuidev/svelte-lang.",
+ "To build generative UI in Svelte, define your components with Zod schemas and render streamed OpenUI Lang with @openuidev/svelte-lang. The UI updates progressively as the model's output arrives.",
howItWorks:
"Svelte component definitions and Zod schemas become one component library. The package generates the model prompt and its Renderer resolves streamed statements into Svelte components.",
install: "npm install @openuidev/svelte-lang",
@@ -789,6 +818,7 @@ const integrationCatalog: Integration[] = [
},
],
links: [
+ { label: "Svelte Lang API reference", href: "/docs/api-reference/svelte-lang", kind: "Docs" },
...packageLinks("@openuidev/svelte-lang", "svelte-lang"),
exampleLink("app-frameworks/svelte"),
{ label: "Svelte", href: "https://svelte.dev", kind: "Website" },
diff --git a/docs/app/blog/[slug]/page.tsx b/docs/app/blog/[slug]/page.tsx
index 073d39d86..01ab882ef 100644
--- a/docs/app/blog/[slug]/page.tsx
+++ b/docs/app/blog/[slug]/page.tsx
@@ -69,7 +69,7 @@ export async function generateMetadata(props: {
if (!page) notFound();
return {
- title: page.data.title,
+ title: page.data.seoTitle ? { absolute: `${page.data.seoTitle} | OpenUI` } : page.data.title,
description: page.data.description,
alternates: {
canonical: page.url,
diff --git a/docs/app/compare/page.tsx b/docs/app/compare/page.tsx
index 15bdca69f..886848574 100644
--- a/docs/app/compare/page.tsx
+++ b/docs/app/compare/page.tsx
@@ -2,13 +2,18 @@ import { createPageMetadata } from "@/lib/page-metadata";
import { parseComparisonPair } from "./_components/chat-types";
import { ComparePageClient } from "./_components/compare-page-client";
-export const metadata = createPageMetadata({
- pathname: "/compare",
- title: "Compare OpenUI",
- description: "Compare rendered Markdown, OpenUI OSS, and OpenUI Cloud side by side.",
- image: "/nav/compare-light.webp",
- imageAlt: "OpenUI comparison preview",
-});
+const TITLE = "Generative UI vs Markdown responses: live comparison | OpenUI";
+
+export const metadata = {
+ ...createPageMetadata({
+ pathname: "/compare",
+ title: TITLE,
+ description: "Compare rendered Markdown, OpenUI OSS, and OpenUI Cloud side by side.",
+ image: "/nav/compare-light.webp",
+ imageAlt: "OpenUI comparison preview",
+ }),
+ title: { absolute: TITLE },
+};
export default async function ComparePage(props: PageProps<"/compare">) {
const searchParams = await props.searchParams;
diff --git a/docs/app/openui-vs-json/layout.tsx b/docs/app/openui-vs-json/layout.tsx
index fb1adf282..c2bf897f6 100644
--- a/docs/app/openui-vs-json/layout.tsx
+++ b/docs/app/openui-vs-json/layout.tsx
@@ -2,14 +2,18 @@ import "@/app/demos/layout.css";
import { WebsiteThemeProvider } from "@/components/website-theme-provider";
import { createPageMetadata } from "@/lib/page-metadata";
import type { ReactNode } from "react";
+import { VS_JSON_SUMMARY, VS_JSON_TITLE } from "./summary";
-export const metadata = createPageMetadata({
- pathname: "/openui-vs-json",
- title: "OpenUI vs JSON",
- description: "See how OpenUI runs 3x faster with 67% fewer tokens than JSON.",
- image: "/nav/vsjson-light.webp",
- imageAlt: "OpenUI versus JSON preview",
-});
+export const metadata = {
+ ...createPageMetadata({
+ pathname: "/openui-vs-json",
+ title: VS_JSON_TITLE,
+ description: VS_JSON_SUMMARY,
+ image: "/nav/vsjson-light.webp",
+ imageAlt: "OpenUI versus JSON preview",
+ }),
+ title: { absolute: VS_JSON_TITLE },
+};
export default function DemosLayout({ children }: { children: ReactNode }) {
return <WebsiteThemeProvider>{children}</WebsiteThemeProvider>;
diff --git a/docs/app/openui-vs-json/summary.ts b/docs/app/openui-vs-json/summary.ts
new file mode 100644
index 000000000..3407fb718
--- /dev/null
+++ b/docs/app/openui-vs-json/summary.ts
@@ -0,0 +1,10 @@
+import { BRIEFS, COST_MODELS, costPerPass, type FormatId, MODELS } from "@/lib/benchmark-data";
+
+const costRatios = (format: FormatId) =>
+ COST_MODELS.map((model) => costPerPass[model]![format] / costPerPass[model]!.openui);
+
+const jsonRatios = [...costRatios("a2ui"), ...costRatios("jsonRender")];
+
+export const VS_JSON_TITLE = "OpenUI vs JSON for generative UI: tokens, speed and cost | OpenUI";
+
+export const VS_JSON_SUMMARY = `OpenUI Lang is a compact language that LLMs write instead of JSON to describe a UI. In our benchmark of ${BRIEFS} screens across ${MODELS.length} models, it used about half the output tokens of JSON formats, so screens stream in about half the time and cost ${Math.min(...jsonRatios).toFixed(1)} to ${Math.max(...jsonRatios).toFixed(1)}× less.`;
diff --git a/docs/content/blog/beyond-the-chatbar.mdx b/docs/content/blog/beyond-the-chatbar.mdx
index a2da04a73..b79661c4f 100644
--- a/docs/content/blog/beyond-the-chatbar.mdx
+++ b/docs/content/blog/beyond-the-chatbar.mdx
@@ -1,6 +1,7 @@
---
title: "SaaS 2.0: Beyond the Chatbar"
-description: "Linear, PostHog, Attio replaced their homepages with chat bars. People hated it. But the frustration is aimed at the delivery mechanism, not the thing being delivered. Here is what comes next."
+seoTitle: "Generative UI for SaaS: beyond the chat bar"
+description: "Generative UI for SaaS means the agent composes the product's interface for each user instead of answering in a chat bar. Linear, PostHog and Attio replaced their homepages with chat bars and people hated it. Here is what comes next."
author: Rabi Guha
date: 2026-04-07
---
diff --git a/docs/content/blog/how-chatgpt-intelligent-ui-works.mdx b/docs/content/blog/how-chatgpt-intelligent-ui-works.mdx
index 205f8c14b..552d9235e 100644
--- a/docs/content/blog/how-chatgpt-intelligent-ui-works.mdx
+++ b/docs/content/blog/how-chatgpt-intelligent-ui-works.mdx
@@ -1,6 +1,7 @@
---
title: "How ChatGPT Intelligent UI works"
-description: "We reverse-engineered how Intelligent UI works in ChatGPT. An inference format, server-side compilation, a client runtime and rendering work together with a design system and catalog to bring Generative UI to life."
+seoTitle: "How ChatGPT's Intelligent UI works (and how to build it in your app)"
+description: "ChatGPT's Intelligent UI works by having the model write a markup language called DIL, which the server compiles to JavaScript and a sandboxed client runtime renders as native components. We reverse-engineered each layer, from the inference format to streaming, data and actions."
author: Thesys Engineering Team
date: 2026-10-08
---
diff --git a/docs/content/blog/state-of-generative-ui-report.mdx b/docs/content/blog/state-of-generative-ui-report.mdx
index e121c9ba8..da14bde68 100644
--- a/docs/content/blog/state-of-generative-ui-report.mdx
+++ b/docs/content/blog/state-of-generative-ui-report.mdx
@@ -1,6 +1,7 @@
---
title: "The State of Generative UI in 2026: Transports, Formats, and Tradeoffs"
-description: "A 2026 survey of Generative UI: AG-UI vs MCP-Apps, Static vs Declarative vs Open-Ended generation, plus token benchmarks for OpenUI, A2UI, and json-render."
+seoTitle: "State of Generative UI 2026: A2UI, AG-UI, MCP Apps and formats compared"
+description: "Generative UI in 2026 comes down to two choices: the transport (AG-UI for your own app, MCP Apps for hosts like ChatGPT and Claude) and the generation format (OpenUI, A2UI, json-render or raw HTML). This report compares them, with token benchmarks and a guide to choosing a stack."
author: Thesys Engineering Team
date: 2026-06-10
featured: true
diff --git a/docs/content/blog/stop-making-ai-write-json.mdx b/docs/content/blog/stop-making-ai-write-json.mdx
index 6c195c52b..d9a61a15b 100644
--- a/docs/content/blog/stop-making-ai-write-json.mdx
+++ b/docs/content/blog/stop-making-ai-write-json.mdx
@@ -1,6 +1,7 @@
---
title: "Stop making AI write JSON - Why we built OpenUI"
-description: "We shipped a JSON-based Generative UI SDK. When we tried to add interactivity, JSON fell apart. A full programming language was worse. This is the story behind why we built OpenUI."
+seoTitle: "JSON vs a DSL for LLM-generated UI: why we stopped making AI write JSON"
+description: "JSON works for static LLM-generated UI, but it breaks down once the UI needs state, live data and actions. We shipped a JSON-based Generative UI SDK, hit that ceiling, and built OpenUI Lang, a line-oriented DSL that models write more reliably and in about half the tokens."
date: "2026-04-10"
author: "Thesys Engineering Team"
featured: false
diff --git a/docs/content/docs/agent/reference/adapters-and-formats.mdx b/docs/content/docs/agent/reference/adapters-and-formats.mdx
index 5a2cd697f..0a17f66be 100644
--- a/docs/content/docs/agent/reference/adapters-and-formats.mdx
+++ b/docs/content/docs/agent/reference/adapters-and-formats.mdx
@@ -613,3 +613,5 @@ import { langGraphMessageFormat } from "@openuidev/react-ui";
How threads, messages, and persistence fit together.
</Card>
</Cards>
+
+Integration overview: [AG-UI frontend: render AG-UI streams as generative UI](/integrations/ag-ui).
diff --git a/docs/content/docs/api-reference/angular-lang.mdx b/docs/content/docs/api-reference/angular-lang.mdx
index 00b99fceb..a253d6d47 100644
--- a/docs/content/docs/api-reference/angular-lang.mdx
+++ b/docs/content/docs/api-reference/angular-lang.mdx
@@ -261,3 +261,5 @@ Inspect `ParseResult.meta.errors` and the renderer's `(error)` output. `OpenUIEr
## Types
The package exports `Library`, `LibraryDefinition`, `DefinedComponent`, `ComponentRenderer` (an Angular `Type<unknown>`), `ComponentRenderProps`, `ComponentGroup`, `PromptOptions`, `RendererProps`, `OpenUiRendererProps`, `OpenUiToolProvider`, `OpenUiContextValue`, `SetDefaultValueOptions`, `FormValidationContextValue`, and the shared Lang Core action, parser, schema, and error types.
+
+Integration overview: [Generative UI for Angular](/integrations/angular).
diff --git a/docs/content/docs/api-reference/react-email.mdx b/docs/content/docs/api-reference/react-email.mdx
index 0463430ed..452e370b6 100644
--- a/docs/content/docs/api-reference/react-email.mdx
+++ b/docs/content/docs/api-reference/react-email.mdx
@@ -64,3 +64,5 @@ const html = await render(
| :------------------- | :-------------- | :------------------------------------------------ |
| `emailLibrary` | `Library` | Ready-to-use library with all 44 email components |
| `emailPromptOptions` | `PromptOptions` | Examples + rules for `emailLibrary.prompt()` |
+
+Integration overview: [Generate React Email templates with an LLM](/integrations/react-email).
diff --git a/docs/content/docs/api-reference/svelte-lang.mdx b/docs/content/docs/api-reference/svelte-lang.mdx
index 4024c91e6..d4110f58c 100644
--- a/docs/content/docs/api-reference/svelte-lang.mdx
+++ b/docs/content/docs/api-reference/svelte-lang.mdx
@@ -223,3 +223,5 @@ In server-only code, import parser and prompt utilities directly from `@openuide
The package exports `Library`, `LibraryDefinition`, `DefinedComponent`, `ComponentRenderer` (a Svelte `Component`), `ComponentRenderProps`, `ComponentGroup`, `SubComponentOf`, `PromptOptions`, `RendererProps`, `OpenUIContextValue`, `ActionConfig`, `FormValidationContextValue`, `ParsedRule`, `ValidatorFn`, and the shared Lang Core `ActionEvent`, `ElementNode`, `ParseResult`, and `LibraryJSONSchema` types.
Other value exports are `tagSchemaId` and `BuiltinActionType`, re-exported from Lang Core.
+
+Integration overview: [Generative UI for Svelte](/integrations/svelte).
diff --git a/docs/content/docs/api-reference/vue-lang.mdx b/docs/content/docs/api-reference/vue-lang.mdx
index fade366f4..75c4c129f 100644
--- a/docs/content/docs/api-reference/vue-lang.mdx
+++ b/docs/content/docs/api-reference/vue-lang.mdx
@@ -250,3 +250,5 @@ Inspect `ParseResult.meta.errors` and the renderer's `onError` callback. `OpenUI
The package exports `Library`, `LibraryDefinition`, `DefinedComponent`, `ComponentRenderer` (a Vue `Component`), `ComponentRenderProps`, `RenderNodeResult`, `ComponentGroup`, `SubComponentOf`, `PromptOptions`, `RendererProps`, `OpenUIContextValue`, `ActionConfig`, `FormValidationContextValue`, `ParsedRule`, `ValidatorFn`, and the shared Lang Core `ActionEvent`, `ElementNode`, `EvaluationContext`, `McpClientLike`, `OpenUIError`, `ParseResult`, `ToolProvider`, and `LibraryJSONSchema` types.
Other value exports are `tagSchemaId`, `BuiltinActionType`, `ToolNotFoundError`, and `extractToolResult`, re-exported from Lang Core. `extractToolResult` unwraps an MCP `callTool` result: it returns `structuredContent` when present, otherwise the text content parsed as JSON when possible, and throws when the result is an error.
+
+Integration overview: [Generative UI for Vue](/integrations/vue).
diff --git a/docs/content/docs/build-agents/assistant-ui.mdx b/docs/content/docs/build-agents/assistant-ui.mdx
index cdde384b8..6fb6c443f 100644
--- a/docs/content/docs/build-agents/assistant-ui.mdx
+++ b/docs/content/docs/build-agents/assistant-ui.mdx
@@ -113,3 +113,5 @@ function OpenUIText({ text, status }: TextMessagePartProps) {
```
The appended message starts a new run, just like a message typed in the composer.
+
+Integration overview: [assistant-ui + OpenUI: generative UI inside assistant-ui chats](/integrations/assistant-ui).
diff --git a/docs/content/docs/build-agents/frameworks/langgraph.mdx b/docs/content/docs/build-agents/frameworks/langgraph.mdx
index f5688883f..499a3a490 100644
--- a/docs/content/docs/build-agents/frameworks/langgraph.mdx
+++ b/docs/content/docs/build-agents/frameworks/langgraph.mdx
@@ -212,3 +212,5 @@ This guide renders the agent with Agent Interface. The backend doesn't depend on
<Card title="CopilotKit" href="/docs/build-agents/copilotkit" />
<Card title="Custom chat UI" href="/docs/build-agents/custom-chat-ui" />
</Cards>
+
+Integration overview: [LangGraph generative UI: build a frontend for LangGraph agents](/integrations/langchain-langgraph).
diff --git a/docs/content/docs/build-agents/frameworks/pi.mdx b/docs/content/docs/build-agents/frameworks/pi.mdx
index 661e15420..6cfe05480 100644
--- a/docs/content/docs/build-agents/frameworks/pi.mdx
+++ b/docs/content/docs/build-agents/frameworks/pi.mdx
@@ -196,3 +196,5 @@ This guide renders the agent with Agent Interface. The backend doesn't depend on
<Card title="CopilotKit" href="/docs/build-agents/copilotkit" />
<Card title="Custom chat UI" href="/docs/build-agents/custom-chat-ui" />
</Cards>
+
+Integration overview: [Pi Coding Agent generative UI with OpenUI](/integrations/pi-coding-agent).
diff --git a/docs/content/docs/build-agents/frameworks/vercel-ai-sdk.mdx b/docs/content/docs/build-agents/frameworks/vercel-ai-sdk.mdx
index 47f0a8430..6c567a97f 100644
--- a/docs/content/docs/build-agents/frameworks/vercel-ai-sdk.mdx
+++ b/docs/content/docs/build-agents/frameworks/vercel-ai-sdk.mdx
@@ -144,3 +144,5 @@ This guide renders the agent with Agent Interface. The backend doesn't depend on
<Card title="CopilotKit" href="/docs/build-agents/copilotkit" />
<Card title="Custom chat UI" href="/docs/build-agents/custom-chat-ui" />
</Cards>
+
+Integration overview: [Vercel AI SDK generative UI with OpenUI](/integrations/vercel-ai-sdk).
diff --git a/docs/content/docs/build-agents/frameworks/vercel-eve.mdx b/docs/content/docs/build-agents/frameworks/vercel-eve.mdx
index eb9e92d64..6a5d9bcd4 100644
--- a/docs/content/docs/build-agents/frameworks/vercel-eve.mdx
+++ b/docs/content/docs/build-agents/frameworks/vercel-eve.mdx
@@ -256,3 +256,5 @@ This guide renders the agent with Agent Interface. The backend doesn't depend on
<Card title="CopilotKit" href="/docs/build-agents/copilotkit" />
<Card title="Custom chat UI" href="/docs/build-agents/custom-chat-ui" />
</Cards>
+
+Integration overview: [Vercel Eve generative UI with OpenUI](/integrations/vercel-eve).
diff --git a/docs/content/docs/openui-lang/examples/design-systems/shadcn.mdx b/docs/content/docs/openui-lang/examples/design-systems/shadcn.mdx
index aa5f05cdf..791745eb1 100644
--- a/docs/content/docs/openui-lang/examples/design-systems/shadcn.mdx
+++ b/docs/content/docs/openui-lang/examples/design-systems/shadcn.mdx
@@ -134,3 +134,5 @@ yarn dev
```bash tab="npm" tab-group="pkg"
npm run dev
```
+
+Integration overview: [shadcn/ui generative UI: let LLMs render your shadcn components](/integrations/shadcn-ui).
diff --git a/docs/source.config.ts b/docs/source.config.ts
index 1fd132d6b..4fcc06e59 100644
--- a/docs/source.config.ts
+++ b/docs/source.config.ts
@@ -32,6 +32,8 @@ export const blogPosts = defineCollections({
type: "doc",
dir: "content/blog",
schema: pageSchema.extend({
+ // Search title for <title>; the H1 keeps `title`.
+ seoTitle: z.string().optional(),
author: z.string(),
date: z.string().date().or(z.date()),
featured: z.boolean().optional(),