Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
39 changes: 39 additions & 0 deletions .github/workflows/content-dates.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
name: Content dates

on:
pull_request:
branches: [main]
# labeled/unlabeled re-run the check when `no-date-bump` is added or removed.
types: [opened, synchronize, reopened, labeled, unlabeled]
paths:
- "docs/content/**"

permissions:
contents: read

jobs:
updated-at:
# A PR that edits a docs page or blog post must also change its `updatedAt`, the page's sitemap
# lastmod. For edits readers won't notice, like a typo fix, label the PR `no-date-bump`.
if: ${{ !contains(github.event.pull_request.labels.*.name, 'no-date-bump') }}
runs-on: ubuntu-latest
steps:
# The PR merge commit and its first parent (the base branch) are all the history this needs.
- uses: actions/checkout@v4
with:
fetch-depth: 2
- name: Edited pages change updatedAt
run: |
# New and edited docs pages, and edited blog posts (new posts are dated by `date`).
files=$({
git diff --name-only --diff-filter=AM HEAD^1 HEAD -- docs/content/docs
git diff --name-only --diff-filter=M HEAD^1 HEAD -- docs/content/blog
} | grep -E '\.mdx?$' || true)
status=0
for file in $files; do
if ! git diff HEAD^1 HEAD -- "$file" | grep -q '^+updatedAt:'; then
echo "::error file=$file::Edited without changing updatedAt. Set it to today's date, or label the PR no-date-bump."
status=1
fi
done
exit $status
4 changes: 4 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -71,6 +71,10 @@ Before opening a pull request, please make sure that:
(patch for fixes and compatible changes; minor for breaking changes — all
packages are 0.x), and commit the generated file. Releases are automated
from these; see [`.changeset/README.md`](./.changeset/README.md).
- If the change edits a docs page or blog post under `docs/content/`, its
`updatedAt` frontmatter is set to today's date. It feeds the sitemap's
`lastmod`, and CI checks it. For typo-level fixes, label the PR
`no-date-bump` instead.

## Bug Reports

Expand Down
4 changes: 3 additions & 1 deletion docs/app/(home)/benchmarks/framework/metadata.ts
Original file line number Diff line number Diff line change
@@ -1,12 +1,14 @@
import { BENCHMARK_UPDATED_ISO } from "@/lib/benchmark-agent-data";
import type { PageMetadataInput } from "@/lib/page-metadata";

export default {
pathname: "/benchmarks/framework",
title: "Generative UI framework benchmark | OpenUI",
title: "Generative UI framework benchmark",
description:
"Compare OpenUI, Google A2UI, and Vercel json-render across six models and 46 interface briefs, with exact server-rendered results and downloads.",
openGraph: {
title: "Framework benchmark",
description: "OpenUI versus Google A2UI versus Vercel json-render under one condition.",
},
updatedAt: BENCHMARK_UPDATED_ISO,
} satisfies PageMetadataInput;
4 changes: 3 additions & 1 deletion docs/app/(home)/benchmarks/language/metadata.ts
Original file line number Diff line number Diff line change
@@ -1,12 +1,14 @@
import { MODEL_BOARD_UPDATED_ISO } from "@/lib/benchmark-agent-data";
import { MODEL_BOARD_SIZE } from "@/lib/benchmark-data";
import type { PageMetadataInput } from "@/lib/page-metadata";

export default {
pathname: "/benchmarks/language",
title: "OpenUI language and model benchmark | OpenUI",
title: "OpenUI language and model benchmark",
description: `Compare structural validity and measured cost across ${MODEL_BOARD_SIZE} models generating OpenUI, with exact server-rendered data and machine-readable downloads.`,
openGraph: {
title: "Language and model benchmark",
description: `Structural validity and cost across ${MODEL_BOARD_SIZE} models generating OpenUI.`,
},
updatedAt: MODEL_BOARD_UPDATED_ISO,
} satisfies PageMetadataInput;
2 changes: 2 additions & 0 deletions docs/app/(home)/benchmarks/metadata.ts
Original file line number Diff line number Diff line change
@@ -1,3 +1,4 @@
import { MODEL_BOARD_UPDATED_ISO } from "@/lib/benchmark-agent-data";
import { blankScreens, COST_MODELS, costPerPass, RUNS_PER_FORMAT } from "@/lib/benchmark-data";
import type { PageMetadataInput } from "@/lib/page-metadata";

Expand All @@ -12,4 +13,5 @@ export default {
title: { absolute: "Generative UI benchmark: OpenUI vs A2UI vs json-render | OpenUI" },
description: `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.`,
openGraph: { title: "Generative UI Benchmark" },
updatedAt: MODEL_BOARD_UPDATED_ISO,
} satisfies PageMetadataInput;
4 changes: 3 additions & 1 deletion docs/app/(home)/benchmarks/methodology/metadata.ts
Original file line number Diff line number Diff line change
@@ -1,12 +1,14 @@
import { METHODOLOGY_UPDATED_ISO } from "@/lib/benchmark-agent-data";
import type { PageMetadataInput } from "@/lib/page-metadata";

export default {
pathname: "/benchmarks/methodology",
title: "Benchmark methodology | OpenUI",
title: "Benchmark methodology",
description:
"How the OpenUI generative UI benchmark is run and scored: 46 briefs, 70 equivalent components, controlled generation settings, and SDK-native validation.",
openGraph: {
title: "Benchmark methodology",
description: "A concise explanation of how the benchmark is generated and scored.",
},
updatedAt: METHODOLOGY_UPDATED_ISO,
} satisfies PageMetadataInput;
6 changes: 3 additions & 3 deletions docs/app/(home)/benchmarks/methodology/page.tsx
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
import { Footer } from "@/app/(home)/sections/Footer/Footer";
import { BENCHMARK_CANONICAL_URL } from "@/lib/benchmark-agent-data";
import { BENCHMARK_CANONICAL_URL, METHODOLOGY_UPDATED_ISO } from "@/lib/benchmark-agent-data";
import {
BRIEFS,
CATALOG_COMPONENTS,
Expand All @@ -17,7 +17,7 @@ import benchmarkStyles from "../benchmarks.module.css";
import page from "./metadata";

export const metadata = createPageMetadata(page, {
openGraph: { type: "article", modifiedTime: "2026-08-26" },
openGraph: { type: "article", modifiedTime: METHODOLOGY_UPDATED_ISO },
});

const SECTIONS = [
Expand All @@ -34,7 +34,7 @@ const structuredData = {
headline: "Generative UI benchmark methodology",
description: "How the OpenUI generative UI benchmark is generated, scored, and reproduced.",
url: `${BENCHMARK_CANONICAL_URL}/methodology`,
dateModified: "2026-08-26",
dateModified: METHODOLOGY_UPDATED_ISO,
author: { "@type": "Organization", name: "OpenUI by Thesys" },
isPartOf: { "@id": `${BENCHMARK_CANONICAL_URL}#dataset` },
codeRepository: REPO_ROOT,
Expand Down
21 changes: 21 additions & 0 deletions docs/app/(home)/integrations/data.ts
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,8 @@ export interface Integration {
name: string;
/** Search title for <title>; the H1 keeps `name`. */
seoTitle: string;
/** YYYY-MM-DD this entry's page content last changed, used as its sitemap `lastmod`. */
updatedAt: string;
logo: string;
category: IntegrationCategoryId;
type: string;
Expand Down Expand Up @@ -89,6 +91,7 @@ const integrationCatalog: Integration[] = [
slug: "shadcn-ui",
name: "shadcn/ui",
seoTitle: "shadcn/ui generative UI: let LLMs render your shadcn components",
updatedAt: "2026-10-12",
logo: "/integration-logos/shadcn-ui.svg",
category: "design-systems",
type: "Design system",
Expand Down Expand Up @@ -127,6 +130,7 @@ const integrationCatalog: Integration[] = [
slug: "material-ui",
name: "Material UI",
seoTitle: "Material UI (MUI) generative UI with OpenUI",
updatedAt: "2026-10-12",
logo: "/integration-logos/mui.svg",
category: "design-systems",
type: "Design system",
Expand Down Expand Up @@ -165,6 +169,7 @@ const integrationCatalog: Integration[] = [
slug: "handsontable",
name: "Handsontable",
seoTitle: "Handsontable generative UI with OpenUI",
updatedAt: "2026-10-12",
logo: "https://raw.githubusercontent.com/handsontable/handsontable/develop/docs/public/favicon.png",
category: "design-systems",
type: "Data grid",
Expand Down Expand Up @@ -198,6 +203,7 @@ const integrationCatalog: Integration[] = [
slug: "react-email",
name: "React Email",
seoTitle: "Generate React Email templates with an LLM",
updatedAt: "2026-10-12",
logo: "/integration-logos/react-email.svg",
category: "design-systems",
type: "Email component library",
Expand Down Expand Up @@ -236,6 +242,7 @@ const integrationCatalog: Integration[] = [
slug: "langchain-langgraph",
name: "LangChain & LangGraph",
seoTitle: "LangGraph generative UI: build a frontend for LangGraph agents",
updatedAt: "2026-10-12",
logo: "https://raw.githubusercontent.com/langchain-ai/docs/main/src/images/brand/langchain-icon.png",
category: "ai-frameworks",
type: "Agent framework adapter",
Expand Down Expand Up @@ -280,6 +287,7 @@ const integrationCatalog: Integration[] = [
slug: "vercel-ai-sdk",
name: "Vercel AI SDK",
seoTitle: "Vercel AI SDK generative UI with OpenUI",
updatedAt: "2026-10-12",
logo: "/integration-logos/vercel.svg",
category: "ai-frameworks",
type: "AI SDK adapter",
Expand Down Expand Up @@ -325,6 +333,7 @@ const integrationCatalog: Integration[] = [
slug: "google-adk",
name: "Google ADK",
seoTitle: "Google ADK agent UI: render rich interfaces with OpenUI",
updatedAt: "2026-10-12",
logo: "/integration-logos/google.svg",
category: "ai-frameworks",
type: "Agent SDK",
Expand Down Expand Up @@ -358,6 +367,7 @@ const integrationCatalog: Integration[] = [
slug: "mastra",
name: "Mastra",
seoTitle: "Mastra generative UI: build a frontend for Mastra agents",
updatedAt: "2026-10-12",
logo: "/integration-logos/mastra.svg",
category: "ai-frameworks",
type: "Agent framework",
Expand Down Expand Up @@ -396,6 +406,7 @@ const integrationCatalog: Integration[] = [
slug: "assistant-ui",
name: "assistant-ui",
seoTitle: "assistant-ui + OpenUI: generative UI inside assistant-ui chats",
updatedAt: "2026-10-12",
logo: "/integration-logos/assistant-ui.svg",
category: "frontend-platforms",
type: "Chat framework",
Expand Down Expand Up @@ -440,6 +451,7 @@ const integrationCatalog: Integration[] = [
slug: "ag-ui",
name: "AG-UI",
seoTitle: "AG-UI frontend: render AG-UI streams as generative UI",
updatedAt: "2026-10-12",
logo: "/integration-logos/ag-ui.svg",
category: "ai-frameworks",
type: "Agent protocol",
Expand Down Expand Up @@ -478,6 +490,7 @@ const integrationCatalog: Integration[] = [
slug: "grok-build",
name: "Grok Build",
seoTitle: "Grok Build generative UI with OpenUI",
updatedAt: "2026-10-12",
logo: "https://media.x.ai/v1/website/spacexai-symbol-black-transparent-6435cf42.png",
category: "ai-frameworks",
type: "Coding agent",
Expand Down Expand Up @@ -511,6 +524,7 @@ const integrationCatalog: Integration[] = [
slug: "vercel-eve",
name: "Vercel Eve",
seoTitle: "Vercel Eve generative UI with OpenUI",
updatedAt: "2026-10-12",
logo: "https://raw.githubusercontent.com/vercel/eve/main/.github/assets/eve.svg",
category: "ai-frameworks",
type: "Coding agent",
Expand Down Expand Up @@ -549,6 +563,7 @@ const integrationCatalog: Integration[] = [
slug: "pi-coding-agent",
name: "Pi Coding Agent",
seoTitle: "Pi Coding Agent generative UI with OpenUI",
updatedAt: "2026-10-12",
logo: "/integration-logos/pi.svg",
category: "ai-frameworks",
type: "Coding agent",
Expand Down Expand Up @@ -589,6 +604,7 @@ const integrationCatalog: Integration[] = [
slug: "open-webui",
name: "Open WebUI",
seoTitle: "Open WebUI generative UI: render rich interfaces in Open WebUI",
updatedAt: "2026-10-12",
logo: "https://raw.githubusercontent.com/open-webui/open-webui/main/backend/open_webui/static/favicon-96x96.png",
category: "frontend-platforms",
type: "AI platform",
Expand Down Expand Up @@ -633,6 +649,7 @@ const integrationCatalog: Integration[] = [
slug: "lynx",
name: "Lynx",
seoTitle: "Lynx generative UI with OpenUI",
updatedAt: "2026-10-12",
logo: "/integration-logos/lynx.svg",
category: "frontend-platforms",
type: "Cross-platform runtime",
Expand Down Expand Up @@ -681,6 +698,7 @@ const integrationCatalog: Integration[] = [
slug: "vue",
name: "Vue 3",
seoTitle: "Generative UI for Vue",
updatedAt: "2026-10-12",
logo: "/integration-logos/vue.svg",
category: "frontend-platforms",
type: "Native runtime",
Expand Down Expand Up @@ -717,6 +735,7 @@ const integrationCatalog: Integration[] = [
slug: "angular",
name: "Angular",
seoTitle: "Generative UI for Angular",
updatedAt: "2026-10-12",
logo: "/integration-logos/angular.svg",
category: "frontend-platforms",
type: "Native runtime",
Expand Down Expand Up @@ -761,6 +780,7 @@ const integrationCatalog: Integration[] = [
slug: "react-native",
name: "React Native",
seoTitle: "Generative UI for React Native",
updatedAt: "2026-10-12",
logo: "/integration-logos/react.svg",
category: "frontend-platforms",
type: "Mobile framework",
Expand Down Expand Up @@ -794,6 +814,7 @@ const integrationCatalog: Integration[] = [
slug: "svelte",
name: "Svelte 5",
seoTitle: "Generative UI for Svelte",
updatedAt: "2026-10-12",
logo: "/integration-logos/svelte.svg",
category: "frontend-platforms",
type: "Native runtime",
Expand Down
27 changes: 23 additions & 4 deletions docs/app/blog/[slug]/page.tsx
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
import { GitHubButton } from "@/app/(home)/components/GitHubButton/GitHubButton";
import { Footer } from "@/app/(home)/sections/Footer/Footer";
import { JsonLd } from "@/components/seo/JsonLd";
import { postDates } from "@/lib/content-dates";
import { blogOgImage } from "@/lib/og/content";
import { ogImageUrl } from "@/lib/og/images";
import { withOgImage } from "@/lib/page-metadata";
Expand All @@ -17,7 +18,8 @@ type BlogSourcePage = NonNullable<ReturnType<typeof blog.getPage>>;
/* BlogPosting and breadcrumb structured data: gives Google the post's dates and author. */
function blogStructuredData(page: BlogSourcePage) {
const url = `${BASE_URL}${page.url}`;
const { title, description, author, date } = page.data;
const { title, description, author } = page.data;
const dates = postDates(page.data);
return [
{
"@context": "https://schema.org",
Expand All @@ -26,8 +28,8 @@ function blogStructuredData(page: BlogSourcePage) {
headline: title,
description,
image: `${BASE_URL}${ogImageUrl(blogOgImage(page))}`,
datePublished: new Date(date).toISOString(),
dateModified: new Date(date).toISOString(),
datePublished: dates.published,
dateModified: dates.modified,
// Bylines are a person or a team ("Thesys Engineering Team").
author: { "@type": /\bteam\b/i.test(author) ? "Organization" : "Person", name: author },
publisher: {
Expand Down Expand Up @@ -55,6 +57,7 @@ export default async function BlogPostPage(props: { params: Promise<{ slug: stri
const page = blog.getPage([params.slug]);

if (!page) notFound();
const dates = postDates(page.data);
const Mdx = page.data.body;
const { faq } = page.data;
const toc = faq?.length
Expand Down Expand Up @@ -92,7 +95,16 @@ export default async function BlogPostPage(props: { params: Promise<{ slug: stri
<div className="flex items-center gap-3 border-b border-[color:var(--home-hairline)] pb-6 text-[length:var(--home-body-size)] font-[family-name:var(--home-font-text)] text-[color:var(--openui-text-neutral-tertiary)]">
<span>{page.data.author}</span>
<span>&middot;</span>
<time>{new Date(page.data.date).toDateString()}</time>
<time dateTime={dates.published}>{new Date(dates.published).toDateString()}</time>
{dates.updated ? (
<>
<span>&middot;</span>
<span>
Updated{" "}
<time dateTime={dates.updated}>{new Date(dates.updated).toDateString()}</time>
</span>
</>
) : null}
</div>
<article className="prose mt-8 min-w-0">
<Mdx components={getMDXComponents()} />
Expand All @@ -116,6 +128,7 @@ export async function generateMetadata(props: {
const page = blog.getPage([params.slug]);

if (!page) notFound();
const dates = postDates(page.data);

return withOgImage(
{
Expand All @@ -124,6 +137,12 @@ export async function generateMetadata(props: {
alternates: {
canonical: page.url,
},
openGraph: {
type: "article",
publishedTime: dates.published,
modifiedTime: dates.modified,
authors: [page.data.author],
},
},
blogOgImage(page),
{ title: page.data.title, description: page.data.description },
Expand Down
2 changes: 1 addition & 1 deletion docs/app/chat/demo/[demoSlug]/page.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ export async function generateMetadata({ params }: DemoChatPageProps) {
// Link previews reuse the /chat card.
return withOgImage(
{
title: `${conversation.title} | OpenUI Cloud Chat`,
title: { absolute: `${conversation.title} | OpenUI Cloud Chat` },
description: conversation.description,
alternates: { canonical: getDemoConversationPath(conversation) },
},
Expand Down
2 changes: 1 addition & 1 deletion docs/app/layout.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ export const metadata: Metadata = {
metadataBase: new URL(BASE_URL),
title: {
default: SITE_TITLE,
template: `%s | ${SITE_TITLE}`,
template: "%s | OpenUI",
},
description: SITE_DESCRIPTION,
applicationName: SITE_TITLE,
Expand Down
Loading
Loading