Skip to content

The Open Standard for Generative UI

docs: shorten page titles, add image alt text and a heading to the GitHub demo (#1416)

devin-ai-integration[bot]dadde1a0c9b6
diff --git a/docs/app/(home)/benchmarks/framework/metadata.ts b/docs/app/(home)/benchmarks/framework/metadata.ts
index 732b1b42e..2b97d66f3 100644
--- a/docs/app/(home)/benchmarks/framework/metadata.ts
+++ b/docs/app/(home)/benchmarks/framework/metadata.ts
@@ -2,7 +2,7 @@ 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: {
diff --git a/docs/app/(home)/benchmarks/language/metadata.ts b/docs/app/(home)/benchmarks/language/metadata.ts
index fbf86eedc..b098f525e 100644
--- a/docs/app/(home)/benchmarks/language/metadata.ts
+++ b/docs/app/(home)/benchmarks/language/metadata.ts
@@ -3,7 +3,7 @@ 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",
diff --git a/docs/app/(home)/benchmarks/methodology/metadata.ts b/docs/app/(home)/benchmarks/methodology/metadata.ts
index 64ec9dcfb..ba9edc565 100644
--- a/docs/app/(home)/benchmarks/methodology/metadata.ts
+++ b/docs/app/(home)/benchmarks/methodology/metadata.ts
@@ -2,7 +2,7 @@ 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: {
diff --git a/docs/app/(home)/cloud/CloudFeatureMarquee.tsx b/docs/app/(home)/cloud/CloudFeatureMarquee.tsx
index be5810296..cee6f8753 100644
--- a/docs/app/(home)/cloud/CloudFeatureMarquee.tsx
+++ b/docs/app/(home)/cloud/CloudFeatureMarquee.tsx
@@ -158,7 +158,7 @@ export function CloudFeatureMarquee() {
<img
className={`${styles.image} ${styles.imageLight}`}
src={feature.lightImage}
- alt=""
+ alt={feature.title}
aria-hidden="true"
loading="lazy"
/>
@@ -166,7 +166,7 @@ export function CloudFeatureMarquee() {
<img
className={`${styles.image} ${styles.imageDark}`}
src={feature.darkImage}
- alt=""
+ alt={feature.title}
aria-hidden="true"
loading="lazy"
/>
diff --git a/docs/app/(home)/cloud/CloudIntegrationSection.tsx b/docs/app/(home)/cloud/CloudIntegrationSection.tsx
index b4b59b147..df401b737 100644
--- a/docs/app/(home)/cloud/CloudIntegrationSection.tsx
+++ b/docs/app/(home)/cloud/CloudIntegrationSection.tsx
@@ -164,7 +164,7 @@ export function CloudIntegrationSection() {
<Image
className={styles.customerBackground}
src={customer.background}
- alt=""
+ alt={`${customer.name} background`}
fill
sizes="(max-width: 767px) 100vw, (max-width: 1023px) 50vw, 400px"
/>
diff --git a/docs/app/(home)/cloud/FeaturesSection.tsx b/docs/app/(home)/cloud/FeaturesSection.tsx
index 76e77f4ca..ae94b792c 100644
--- a/docs/app/(home)/cloud/FeaturesSection.tsx
+++ b/docs/app/(home)/cloud/FeaturesSection.tsx
@@ -113,7 +113,7 @@ export function CloudFeatureCard({
<Image
className={`${styles.featureImage} ${styles.featureImageDark}`}
src={imageDark}
- alt=""
+ alt={imageAlt ?? title}
aria-hidden="true"
width={720}
height={400}
@@ -133,7 +133,7 @@ export function CloudFeatureCard({
<Image
className={`${styles.featureImage} ${styles.featureImageDark}`}
src={imageMobileDark}
- alt=""
+ alt={imageAlt ?? title}
aria-hidden="true"
width={720}
height={600}
diff --git a/docs/app/(home)/cloud/gateway/RepairSection.tsx b/docs/app/(home)/cloud/gateway/RepairSection.tsx
index a5a25c670..a9e4f93fb 100644
--- a/docs/app/(home)/cloud/gateway/RepairSection.tsx
+++ b/docs/app/(home)/cloud/gateway/RepairSection.tsx
@@ -92,7 +92,12 @@ export function RepairSection() {
rel="noreferrer"
>
<span className={styles.quoteLogo}>
- <Image src="/logos/entelligence-mark.svg" alt="" width={32} height={32} />
+ <Image
+ src="/logos/entelligence-mark.svg"
+ alt="Entelligence logo"
+ width={32}
+ height={32}
+ />
</span>
<span className={styles.quoteCompany}>Entelligence</span>
</a>{" "}
diff --git a/docs/app/(home)/cloud/gateway/models/ModelsTable.tsx b/docs/app/(home)/cloud/gateway/models/ModelsTable.tsx
index d76db7ee0..20d5e9a42 100644
--- a/docs/app/(home)/cloud/gateway/models/ModelsTable.tsx
+++ b/docs/app/(home)/cloud/gateway/models/ModelsTable.tsx
@@ -455,7 +455,7 @@ function ModelCell({ id, name }: { id: string; name: string }) {
style={{ maskImage: `url(${icon.src})`, WebkitMaskImage: `url(${icon.src})` }}
/>
) : (
- <Image src={icon.src} alt="" width={16} height={16} unoptimized />
+ <Image src={icon.src} alt={`${slugOf(id)} logo`} width={16} height={16} unoptimized />
)}
</span>
<div className={styles.modelText}>
diff --git a/docs/app/(home)/cloud/observability/FeaturesSection.tsx b/docs/app/(home)/cloud/observability/FeaturesSection.tsx
index e320ce789..7a8601579 100644
--- a/docs/app/(home)/cloud/observability/FeaturesSection.tsx
+++ b/docs/app/(home)/cloud/observability/FeaturesSection.tsx
@@ -75,7 +75,7 @@ function FeatureShot({ shot, alt }: { shot?: string; alt: string }) {
<Image
className={`${styles.featureImage} ${styles.featureImageDark} ${focalClass}`.trim()}
src={`/openui-observability/${shot}-dark.webp`}
- alt=""
+ alt={alt}
aria-hidden="true"
width={2880}
height={imageHeight}
@@ -98,7 +98,7 @@ function FeatureShot({ shot, alt }: { shot?: string; alt: string }) {
<Image
className={`${styles.featureImage} ${styles.featureImageDark}`}
src={`/openui-observability/${shot}-mobile-dark.webp`}
- alt=""
+ alt={alt}
aria-hidden="true"
width={720}
height={600}
diff --git a/docs/app/(home)/cloud/observability/page.tsx b/docs/app/(home)/cloud/observability/page.tsx
index f4057d9bb..7465acbdf 100644
--- a/docs/app/(home)/cloud/observability/page.tsx
+++ b/docs/app/(home)/cloud/observability/page.tsx
@@ -116,7 +116,7 @@ export default function ObservabilityPage() {
<Image
className={`${cloudStyles.heroImage} ${cloudStyles.heroImageDark}`}
src="/openui-observability/hero-dark.webp"
- alt=""
+ alt="OpenUI Observability dashboard"
aria-hidden="true"
width={1280}
height={600}
@@ -141,7 +141,7 @@ export default function ObservabilityPage() {
<Image
className={`${cloudStyles.heroImage} ${cloudStyles.heroImageMobile} ${cloudStyles.heroImageDark}`}
src="/openui-observability/hero-mobile-dark.webp"
- alt=""
+ alt="OpenUI Observability dashboard"
aria-hidden="true"
width={924}
height={1040}
diff --git a/docs/app/(home)/cloud/page.tsx b/docs/app/(home)/cloud/page.tsx
index 6917c3552..a940784b6 100644
--- a/docs/app/(home)/cloud/page.tsx
+++ b/docs/app/(home)/cloud/page.tsx
@@ -108,7 +108,7 @@ export default function OpenUICloudPage() {
<Image
className={`${cloudStyles.heroImage} ${cloudStyles.heroImageDark}`}
src="/openui-cloud/hero-dark.svg"
- alt=""
+ alt="OpenUI Cloud"
aria-hidden="true"
width={1280}
height={600}
@@ -129,7 +129,7 @@ export default function OpenUICloudPage() {
<Image
className={`${cloudStyles.heroImage} ${cloudStyles.heroImageDark}`}
src="/openui-cloud/hero-dark.svg"
- alt=""
+ alt="OpenUI Cloud"
aria-hidden="true"
width={1280}
height={600}
diff --git a/docs/app/(home)/components/AgentPicker/AgentPicker.tsx b/docs/app/(home)/components/AgentPicker/AgentPicker.tsx
index b97a1de38..75b5cc70a 100644
--- a/docs/app/(home)/components/AgentPicker/AgentPicker.tsx
+++ b/docs/app/(home)/components/AgentPicker/AgentPicker.tsx
@@ -94,7 +94,7 @@ function AgentButton({
.replace(/\s+/g, " ")
.trim()}
src={agent.mark}
- alt=""
+ alt={`${agent.label} logo`}
aria-hidden="true"
width={20}
height={20}
diff --git a/docs/app/(home)/components/StackChip/StackChip.tsx b/docs/app/(home)/components/StackChip/StackChip.tsx
index 67d8998fa..6a7eb1a52 100644
--- a/docs/app/(home)/components/StackChip/StackChip.tsx
+++ b/docs/app/(home)/components/StackChip/StackChip.tsx
@@ -47,7 +47,7 @@ function ChipIcon({ item }: { item: StackChipItem }) {
const imgSrc = item.localSrc ?? `https://cdn.simpleicons.org/${item.slug}/${item.iconColor}`;
return (
// eslint-disable-next-line @next/next/no-img-element
- <img src={imgSrc} alt="" width={16} height={16} className={styles.badgeImage} />
+ <img src={imgSrc} alt={item.name} width={16} height={16} className={styles.badgeImage} />
);
}
case "vector": {
@@ -76,7 +76,7 @@ function ChipIcon({ item }: { item: StackChipItem }) {
<img
className={styles.mascotSvg}
src="/shiro-logo.svg"
- alt=""
+ alt="OpenUI"
aria-hidden="true"
style={{ objectFit: "contain" }}
/>
diff --git a/docs/app/(home)/components/StaticTweetCard/StaticTweetCard.tsx b/docs/app/(home)/components/StaticTweetCard/StaticTweetCard.tsx
index a7b5b0f03..69b1e6353 100644
--- a/docs/app/(home)/components/StaticTweetCard/StaticTweetCard.tsx
+++ b/docs/app/(home)/components/StaticTweetCard/StaticTweetCard.tsx
@@ -40,7 +40,14 @@ function XLogo() {
function VerifiedBadge() {
return (
- <svg viewBox="0 0 24 24" width="16" height="16" fill="#1d9bf0" aria-label="Verified account" className={styles.verified}>
+ <svg
+ viewBox="0 0 24 24"
+ width="16"
+ height="16"
+ fill="#1d9bf0"
+ aria-label="Verified account"
+ className={styles.verified}
+ >
<path d="M22.25 12c0-1.43-.88-2.67-2.19-3.34.46-1.39.2-2.9-.81-3.91s-2.52-1.27-3.91-.81c-.66-1.31-1.91-2.19-3.34-2.19s-2.68.88-3.34 2.19c-1.39-.46-2.9-.2-3.91.81s-1.26 2.52-.81 3.91c-1.31.66-2.19 1.91-2.19 3.34s.88 2.67 2.19 3.34c-.46 1.39-.2 2.9.81 3.91s2.52 1.26 3.91.81c.66 1.31 1.91 2.19 3.34 2.19s2.68-.88 3.34-2.19c1.39.46 2.9.2 3.91-.81s1.27-2.52.81-3.91c1.31-.67 2.19-1.91 2.19-3.34zm-11.71 4.2L6.8 12.46l1.41-1.42 2.26 2.26 4.8-5.23 1.47 1.36-6.2 6.77z" />
</svg>
);
@@ -64,7 +71,17 @@ function ReplyIcon() {
function LinkIcon() {
return (
- <svg viewBox="0 0 24 24" width="15" height="15" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true">
+ <svg
+ viewBox="0 0 24 24"
+ width="15"
+ height="15"
+ fill="none"
+ stroke="currentColor"
+ strokeWidth="2"
+ strokeLinecap="round"
+ strokeLinejoin="round"
+ aria-hidden="true"
+ >
<path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71" />
<path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71" />
</svg>
@@ -100,7 +117,14 @@ export function StaticTweetCard({ tweet }: { tweet: StaticTweet }) {
<div className={styles.header}>
{/* eslint-disable-next-line @next/next/no-img-element */}
- <img className={styles.avatar} src={tweet.avatar} alt="" width={40} height={40} loading="lazy" />
+ <img
+ className={styles.avatar}
+ src={tweet.avatar}
+ alt={tweet.name}
+ width={40}
+ height={40}
+ loading="lazy"
+ />
<div className={styles.identity}>
<span className={styles.name}>
<span className={styles.nameText}>{tweet.name}</span>
@@ -118,7 +142,7 @@ export function StaticTweetCard({ tweet }: { tweet: StaticTweet }) {
{tweet.media && (
<div className={styles.media} data-type={tweet.media.type}>
{/* eslint-disable-next-line @next/next/no-img-element */}
- <img src={tweet.media.url} alt="" loading="lazy" />
+ <img src={tweet.media.url} alt={`Image from ${tweet.name}'s tweet`} loading="lazy" />
{tweet.media.type === "video" && (
<span className={styles.playButton} aria-hidden="true">
<svg viewBox="0 0 24 24" width="22" height="22" fill="currentColor">
diff --git a/docs/app/(home)/integrations/data.ts b/docs/app/(home)/integrations/data.ts
index 7e050112c..25c42d9b1 100644
--- a/docs/app/(home)/integrations/data.ts
+++ b/docs/app/(home)/integrations/data.ts
@@ -88,7 +88,7 @@ const integrationCatalog: Integration[] = [
{
slug: "shadcn-ui",
name: "shadcn/ui",
- seoTitle: "shadcn/ui generative UI: let LLMs render your shadcn components",
+ seoTitle: "shadcn/ui generative UI: let LLMs render your components",
logo: "/integration-logos/shadcn-ui.svg",
category: "design-systems",
type: "Design system",
@@ -235,7 +235,7 @@ const integrationCatalog: Integration[] = [
{
slug: "langchain-langgraph",
name: "LangChain & LangGraph",
- seoTitle: "LangGraph generative UI: build a frontend for LangGraph agents",
+ seoTitle: "LangGraph generative UI: 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",
@@ -395,7 +395,7 @@ const integrationCatalog: Integration[] = [
{
slug: "assistant-ui",
name: "assistant-ui",
- seoTitle: "assistant-ui + OpenUI: generative UI inside assistant-ui chats",
+ seoTitle: "assistant-ui + OpenUI: generative UI in assistant-ui chats",
logo: "/integration-logos/assistant-ui.svg",
category: "frontend-platforms",
type: "Chat framework",
@@ -588,7 +588,7 @@ const integrationCatalog: Integration[] = [
{
slug: "open-webui",
name: "Open WebUI",
- seoTitle: "Open WebUI generative UI: render rich interfaces in Open WebUI",
+ seoTitle: "Open WebUI generative UI: 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",
diff --git a/docs/app/(home)/integrations/integration-logo.tsx b/docs/app/(home)/integrations/integration-logo.tsx
index 612af03f4..566fa094a 100644
--- a/docs/app/(home)/integrations/integration-logo.tsx
+++ b/docs/app/(home)/integrations/integration-logo.tsx
@@ -10,7 +10,7 @@ export function IntegrationLogo({ integration, className }: IntegrationLogoProps
<span className={className} aria-hidden="true">
{/* Brand marks are intentionally rendered at their intrinsic aspect ratio. */}
{/* eslint-disable-next-line @next/next/no-img-element */}
- <img alt="" src={integration.logo ?? "/favicon.svg"} />
+ <img alt={`${integration.name} logo`} src={integration.logo ?? "/favicon.svg"} />
</span>
);
}
diff --git a/docs/app/(home)/openclaw-os/page.tsx b/docs/app/(home)/openclaw-os/page.tsx
index 90cffbf96..da55a0519 100644
--- a/docs/app/(home)/openclaw-os/page.tsx
+++ b/docs/app/(home)/openclaw-os/page.tsx
@@ -29,7 +29,7 @@ export default function OpenClawOSPage() {
<>
The Default workspace for{" "}
<span className={heroStyles.subtitleLogoTile} aria-hidden="true">
- <img src="/openclaw-dark.svg" alt="" />
+ <img src="/openclaw-dark.svg" alt="OpenClaw logo" />
</span>
OpenClaw.
</>
diff --git a/docs/app/(home)/sections/AutofixSection/AutofixSection.tsx b/docs/app/(home)/sections/AutofixSection/AutofixSection.tsx
index 5f97fc4b4..a24914c7d 100644
--- a/docs/app/(home)/sections/AutofixSection/AutofixSection.tsx
+++ b/docs/app/(home)/sections/AutofixSection/AutofixSection.tsx
@@ -50,7 +50,7 @@ export function AutofixSection({
<Image
className={`${provider.markClass} ${"darkIcon" in provider ? styles.providerLogoLight : ""}`.trim()}
src={provider.icon}
- alt=""
+ alt={`${provider.name} logo`}
width={18}
height={18}
/>
@@ -58,7 +58,7 @@ export function AutofixSection({
<Image
className={`${provider.markClass} ${styles.providerLogoDark}`}
src={provider.darkIcon}
- alt=""
+ alt={`${provider.name} logo`}
width={18}
height={18}
/>
@@ -91,7 +91,7 @@ export function AutofixSection({
<Image
className={`${styles.illustrationImage} ${styles.illustrationImageLight}`}
src="/images/gateway/autofix-illustration-light.webp"
- alt=""
+ alt="Invalid generated output corrected into valid UI by Autofix"
width={1940}
height={636}
unoptimized
@@ -99,7 +99,7 @@ export function AutofixSection({
<Image
className={`${styles.illustrationImage} ${styles.illustrationImageDark}`}
src="/images/gateway/autofix-illustration-dark.webp"
- alt=""
+ alt="Invalid generated output corrected into valid UI by Autofix"
width={1940}
height={636}
unoptimized
diff --git a/docs/app/(home)/sections/CloudSection/CloudSection.tsx b/docs/app/(home)/sections/CloudSection/CloudSection.tsx
index 32d6746e1..848a127cb 100644
--- a/docs/app/(home)/sections/CloudSection/CloudSection.tsx
+++ b/docs/app/(home)/sections/CloudSection/CloudSection.tsx
@@ -84,7 +84,7 @@ export function CloudSection() {
<Image
className={`${styles.observabilityImage} ${styles.observabilityImageLight}`}
src="/homepage/observability-light.webp"
- alt=""
+ alt="OpenUI Observability dashboard"
aria-hidden="true"
width={2240}
height={880}
@@ -94,7 +94,7 @@ export function CloudSection() {
<Image
className={`${styles.observabilityImage} ${styles.observabilityImageDark}`}
src="/homepage/observability-dark.webp"
- alt=""
+ alt="OpenUI Observability dashboard"
aria-hidden="true"
width={2240}
height={880}
@@ -106,7 +106,7 @@ export function CloudSection() {
<Image
className={`${styles.observabilityImage} ${styles.observabilityImageLight}`}
src="/homepage/observability-mobile-light.webp"
- alt=""
+ alt="OpenUI Observability dashboard"
aria-hidden="true"
width={1440}
height={1200}
@@ -116,7 +116,7 @@ export function CloudSection() {
<Image
className={`${styles.observabilityImage} ${styles.observabilityImageDark}`}
src="/homepage/observability-mobile-dark.webp"
- alt=""
+ alt="OpenUI Observability dashboard"
aria-hidden="true"
width={1440}
height={1200}
diff --git a/docs/app/(home)/sections/LogoStrip/LogoStrip.tsx b/docs/app/(home)/sections/LogoStrip/LogoStrip.tsx
index 82b20f547..2a54ac9e4 100644
--- a/docs/app/(home)/sections/LogoStrip/LogoStrip.tsx
+++ b/docs/app/(home)/sections/LogoStrip/LogoStrip.tsx
@@ -54,7 +54,8 @@ export function LogoStrip({
<Image
className={styles.logo}
src={logo.src}
- alt={set === 0 ? logo.alt : ""}
+ alt={logo.alt}
+ aria-hidden={set === 0 ? undefined : true}
width={160}
height={48}
loading="lazy"
diff --git a/docs/app/(home)/sections/PossibilitiesSection/PossibilitiesSection.tsx b/docs/app/(home)/sections/PossibilitiesSection/PossibilitiesSection.tsx
index 6748b9215..7a75a9751 100644
--- a/docs/app/(home)/sections/PossibilitiesSection/PossibilitiesSection.tsx
+++ b/docs/app/(home)/sections/PossibilitiesSection/PossibilitiesSection.tsx
@@ -71,7 +71,7 @@ function Card({ title, titlePrefix, image, lightImage, darkImage, href }: CardPr
/>
<img
src={darkImage}
- alt=""
+ alt={`${title} illustration`}
aria-hidden="true"
className={`${styles.cardImage} ${styles.cardImageDark}`}
draggable={false}
diff --git a/docs/app/(home)/sections/ProductIllustrations/OpenSourceIllustration.tsx b/docs/app/(home)/sections/ProductIllustrations/OpenSourceIllustration.tsx
index 1e418efcb..de71579a5 100644
--- a/docs/app/(home)/sections/ProductIllustrations/OpenSourceIllustration.tsx
+++ b/docs/app/(home)/sections/ProductIllustrations/OpenSourceIllustration.tsx
@@ -12,7 +12,7 @@ export function OpenSourceIllustration({ theme }: { theme?: "light" | "dark" } =
<Image
className={`${styles.image} ${styles.imageLight}`}
src="/openui-illustrations/home-open-source-light.webp"
- alt=""
+ alt="OpenUI Lang code generating a trip-planning interface"
aria-hidden="true"
fill
quality={95}
@@ -22,7 +22,7 @@ export function OpenSourceIllustration({ theme }: { theme?: "light" | "dark" } =
<Image
className={`${styles.image} ${styles.imageDark}`}
src="/openui-illustrations/home-open-source-dark.webp"
- alt=""
+ alt="OpenUI Lang code generating a trip-planning interface"
aria-hidden="true"
fill
quality={95}
diff --git a/docs/app/(home)/sections/ProductIllustrations/ProductIllustrations.tsx b/docs/app/(home)/sections/ProductIllustrations/ProductIllustrations.tsx
index ef6308cf7..013a1e6a9 100644
--- a/docs/app/(home)/sections/ProductIllustrations/ProductIllustrations.tsx
+++ b/docs/app/(home)/sections/ProductIllustrations/ProductIllustrations.tsx
@@ -33,7 +33,7 @@ export function GatewayReliabilityDashboardIllustration({
<Image
className={`${styles.reliabilityDashboardImage} ${styles.reliabilityDashboardImageDark}`}
src="/homepage/gateway-dark.webp"
- alt=""
+ alt={alt}
aria-hidden="true"
width={2240}
height={880}
@@ -54,7 +54,7 @@ export function GatewayReliabilityDashboardIllustration({
<Image
className={`${styles.reliabilityDashboardImage} ${styles.reliabilityDashboardImageDark}`}
src="/homepage/gateway-mobile-dark.webp"
- alt=""
+ alt={alt}
aria-hidden="true"
width={1440}
height={1200}
@@ -88,7 +88,9 @@ const openResponseLanes = [
{
path: "M 111 210 H 174 C 206 210 214 220 232 232 S 260 246 288 246 H 306 C 332 246 350 246 405 246",
},
- { path: "M 97 310 H 174 C 206 310 214 300 232 288 S 260 274 288 274 H 306 C 332 274 350 274 405 274" },
+ {
+ path: "M 97 310 H 174 C 206 310 214 300 232 288 S 260 274 288 274 H 306 C 332 274 350 274 405 274",
+ },
{
path: "M 83 411 H 174 C 204 411 210 386 228 356 S 258 322 286 322 H 304 C 330 322 344 304 405 298",
},
@@ -251,7 +253,7 @@ function GatewayReliabilityFlow({ openCanvas = false }: { openCanvas?: boolean }
key={`model-slot-${slot}`}
>
<span className={styles.modelSourceIcon}>
- <Image src={model.src} alt="" width={14} height={14} />
+ <Image src={model.src} alt={`${model.name} logo`} width={14} height={14} />
</span>
<span>{model.name}</span>
</div>
@@ -283,7 +285,7 @@ function GatewayReliabilityFlow({ openCanvas = false }: { openCanvas?: boolean }
<Image
className={styles.renderedInterfaceLight}
src="/images/gateway/[email protected]"
- alt=""
+ alt="Generative UI rendered by OpenUI"
width={1716}
height={1367}
unoptimized
@@ -291,7 +293,7 @@ function GatewayReliabilityFlow({ openCanvas = false }: { openCanvas?: boolean }
<Image
className={styles.renderedInterfaceDark}
src="/images/gateway/[email protected]"
- alt=""
+ alt="Generative UI rendered by OpenUI"
width={1716}
height={1367}
unoptimized
diff --git a/docs/app/(home)/sections/ShiroPeek/ShiroPeek.tsx b/docs/app/(home)/sections/ShiroPeek/ShiroPeek.tsx
index cc19e0aa6..399e3a800 100644
--- a/docs/app/(home)/sections/ShiroPeek/ShiroPeek.tsx
+++ b/docs/app/(home)/sections/ShiroPeek/ShiroPeek.tsx
@@ -5,7 +5,7 @@ export function ShiroPeek() {
<div className={styles.root}>
<div className={styles.figure}>
{/* eslint-disable-next-line @next/next/no-img-element */}
- <img className={styles.svg} src="/shiro-peek.svg" alt="" aria-hidden="true" />
+ <img className={styles.svg} src="/shiro-peek.svg" alt="OpenUI mascot" aria-hidden="true" />
</div>
</div>
);
diff --git a/docs/app/(home)/sections/StackDiagramSection/StackDiagramSection.tsx b/docs/app/(home)/sections/StackDiagramSection/StackDiagramSection.tsx
index 2f14458d1..54eeb0bea 100644
--- a/docs/app/(home)/sections/StackDiagramSection/StackDiagramSection.tsx
+++ b/docs/app/(home)/sections/StackDiagramSection/StackDiagramSection.tsx
@@ -56,7 +56,7 @@ function WorksWith({ marks }: { marks: WorksWithMark[] }) {
<img
className={styles.wordmarkWhite}
src={`${mark.base}-white.svg`}
- alt=""
+ alt={mark.name}
aria-hidden="true"
style={{ height: mark.height }}
loading="lazy"
diff --git a/docs/app/blog/page.tsx b/docs/app/blog/page.tsx
index 3715e6b9d..0842ba9b7 100644
--- a/docs/app/blog/page.tsx
+++ b/docs/app/blog/page.tsx
@@ -128,7 +128,7 @@ function FeaturedCard({ card }: { card: BlogCardData }) {
{card.image ? (
<img
src={card.image}
- alt=""
+ alt={card.title}
loading="lazy"
className="absolute inset-0 h-full w-full object-cover"
/>
@@ -167,7 +167,7 @@ function RegularCard({ card }: { card: BlogCardData }) {
{card.image ? (
<img
src={card.image}
- alt=""
+ alt={card.title}
loading="lazy"
className="absolute inset-0 h-full w-full object-cover"
/>
diff --git a/docs/app/demo/github/components/GitHubConnect/GitHubConnect.tsx b/docs/app/demo/github/components/GitHubConnect/GitHubConnect.tsx
index 4b4c20f14..5213f05f6 100644
--- a/docs/app/demo/github/components/GitHubConnect/GitHubConnect.tsx
+++ b/docs/app/demo/github/components/GitHubConnect/GitHubConnect.tsx
@@ -79,7 +79,7 @@ function renderOptionLeading(option: PickerOption) {
return option.avatarUsername ? (
<img
src={`https://github.com/${option.avatarUsername}.png?size=40`}
- alt=""
+ alt={`${option.avatarUsername} avatar`}
className="gh-choiceAvatar"
/>
) : (
@@ -295,7 +295,7 @@ export function GitHubConnect({ onConnectAndPrompt }: GitHubConnectProps) {
<span className="gh-chip gh-chip-neutral">
<span className="gh-chipLeading">
{avatarUrl ? (
- <img src={avatarUrl} alt="" className="gh-chipAvatar" />
+ <img src={avatarUrl} alt="GitHub avatar" className="gh-chipAvatar" />
) : (
<span className="gh-chipMonogram">@</span>
)}
@@ -314,7 +314,7 @@ export function GitHubConnect({ onConnectAndPrompt }: GitHubConnectProps) {
}
return (
<span className={`gh-inputWrap ${avatarUrl ? "gh-inputWrap-withAvatar" : ""}`}>
- {avatarUrl && <img src={avatarUrl} alt="" className="gh-chipAvatar" />}
+ {avatarUrl && <img src={avatarUrl} alt="GitHub avatar" className="gh-chipAvatar" />}
<span className="gh-inputPrefix">@</span>
<span className="gh-inputSizer">
<span className="gh-inputGhost">{username || "username"}</span>
diff --git a/docs/app/demo/github/components/SavedSidebar/SavedSidebar.tsx b/docs/app/demo/github/components/SavedSidebar/SavedSidebar.tsx
index 2c2274e4d..3eafc32cd 100644
--- a/docs/app/demo/github/components/SavedSidebar/SavedSidebar.tsx
+++ b/docs/app/demo/github/components/SavedSidebar/SavedSidebar.tsx
@@ -32,7 +32,7 @@ export function SavedSidebar({
>
<img
src={`https://github.com/${d.username}.png?size=32`}
- alt=""
+ alt={`${d.username} avatar`}
className="saved-sidebar-avatar"
/>
<div className="saved-sidebar-item-text">
diff --git a/docs/app/demo/github/page.tsx b/docs/app/demo/github/page.tsx
index de85d4c22..359458192 100644
--- a/docs/app/demo/github/page.tsx
+++ b/docs/app/demo/github/page.tsx
@@ -546,6 +546,7 @@ export default function GitHubDemoPage() {
return (
<div className={`app ${isHomeState ? "app-home" : "app-artifact"}`}>
+ <h1 className="sr-only">OpenUI GitHub Dashboard Demo</h1>
<Header
theme={currentTheme}
onThemeToggle={cycleTheme}
@@ -583,7 +584,7 @@ export default function GitHubDemoPage() {
<span className="gh-welcome-avatar">
<img
src={`https://github.com/${githubUsername}.png?size=32`}
- alt=""
+ alt={`${githubUsername} avatar`}
className="gh-welcome-avatar-image"
/>
</span>
@@ -724,7 +725,7 @@ export default function GitHubDemoPage() {
<div className="gh-connected-bar">
<img
src={`https://github.com/${githubUsername}.png?size=32`}
- alt=""
+ alt={`${githubUsername} avatar`}
className="gh-connected-avatar"
/>
<span>@{githubUsername}</span>
diff --git a/docs/app/layout.tsx b/docs/app/layout.tsx
index 4d7d6b459..45eda568f 100644
--- a/docs/app/layout.tsx
+++ b/docs/app/layout.tsx
@@ -32,7 +32,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,
diff --git a/docs/components/brand-logo.tsx b/docs/components/brand-logo.tsx
index d351b946f..1469186fc 100644
--- a/docs/components/brand-logo.tsx
+++ b/docs/components/brand-logo.tsx
@@ -96,7 +96,7 @@ export function OpenUILogo({ variant = "light" }: { variant?: LogoVariant }) {
{/* eslint-disable-next-line @next/next/no-img-element */}
<img
src="/shiro-logo.svg"
- alt=""
+ alt="OpenUI"
aria-hidden="true"
className="absolute inset-0 block size-full object-contain"
/>
diff --git a/docs/components/showcase/cards.tsx b/docs/components/showcase/cards.tsx
index 6e008c25f..b983e4a9d 100644
--- a/docs/components/showcase/cards.tsx
+++ b/docs/components/showcase/cards.tsx
@@ -45,9 +45,19 @@ export function ShowcaseGrid({ items }: { items: ShowcaseItem[] }) {
<article key={item.name} className={styles.featuredCard}>
<div className={styles.featuredMedia}>
{/* eslint-disable-next-line @next/next/no-img-element */}
- <img className={styles.imageLight} src={item.image.light} alt="" loading="lazy" />
+ <img
+ className={styles.imageLight}
+ src={item.image.light}
+ alt={item.name}
+ loading="lazy"
+ />
{/* eslint-disable-next-line @next/next/no-img-element */}
- <img className={styles.imageDark} src={item.image.dark} alt="" loading="lazy" />
+ <img
+ className={styles.imageDark}
+ src={item.image.dark}
+ alt={item.name}
+ loading="lazy"
+ />
</div>
<div className={styles.featuredBody}>
<span className={styles.eyebrow}>{item.tagline}</span>
diff --git a/docs/components/showcase/examples.tsx b/docs/components/showcase/examples.tsx
index f77cd85cc..43f649d1f 100644
--- a/docs/components/showcase/examples.tsx
+++ b/docs/components/showcase/examples.tsx
@@ -25,7 +25,7 @@ export function ExampleCategory({ id }: { id: ExampleCategoryId }) {
{/* Brand marks keep their intrinsic aspect ratio, as on the integrations page. */}
{/* eslint-disable-next-line @next/next/no-img-element */}
<img
- alt=""
+ alt={`${example.name} logo`}
src={example.logo}
className={example.logoIsDark ? styles.cardLogoDark : styles.cardLogo}
/>
diff --git a/docs/components/site-primary-nav.tsx b/docs/components/site-primary-nav.tsx
index 8b6006604..3cb9a013e 100644
--- a/docs/components/site-primary-nav.tsx
+++ b/docs/components/site-primary-nav.tsx
@@ -325,7 +325,7 @@ function renderBody(child: NavDropdownChild, layout: "cards" | "list") {
there's no hydration flash on first paint. */}
<img
src={child.preview.light}
- alt=""
+ alt={`${child.title} preview`}
aria-hidden="true"
width={852}
height={480}
@@ -335,7 +335,7 @@ function renderBody(child: NavDropdownChild, layout: "cards" | "list") {
/>
<img
src={child.preview.dark}
- alt=""
+ alt={`${child.title} preview`}
aria-hidden="true"
width={852}
height={480}
diff --git a/docs/content/blog/how-chatgpt-intelligent-ui-works.mdx b/docs/content/blog/how-chatgpt-intelligent-ui-works.mdx
index 3e763667d..4539fb3c3 100644
--- a/docs/content/blog/how-chatgpt-intelligent-ui-works.mdx
+++ b/docs/content/blog/how-chatgpt-intelligent-ui-works.mdx
@@ -1,6 +1,6 @@
---
title: "How ChatGPT Intelligent UI works"
-seoTitle: "How ChatGPT's Intelligent UI works (and how to build it in your app)"
+seoTitle: "How ChatGPT's Intelligent UI works and how to build it"
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 4e2c12bc3..6dbccb037 100644
--- a/docs/content/blog/state-of-generative-ui-report.mdx
+++ b/docs/content/blog/state-of-generative-ui-report.mdx
@@ -1,6 +1,6 @@
---
title: "The State of Generative UI in 2026: Transports, Formats, and Tradeoffs"
-seoTitle: "State of Generative UI 2026: A2UI, AG-UI, MCP Apps and formats compared"
+seoTitle: "State of Generative UI 2026: A2UI, AG-UI, MCP Apps 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
diff --git a/docs/content/blog/stop-making-ai-write-json.mdx b/docs/content/blog/stop-making-ai-write-json.mdx
index c974a58d3..c2938270a 100644
--- a/docs/content/blog/stop-making-ai-write-json.mdx
+++ b/docs/content/blog/stop-making-ai-write-json.mdx
@@ -1,6 +1,6 @@
---
title: "Stop making AI write JSON - Why we built OpenUI"
-seoTitle: "JSON vs a DSL for LLM-generated UI: why we stopped making AI write JSON"
+seoTitle: "JSON vs a DSL for LLM UI: why AI shouldn't 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"
diff --git a/docs/content/docs/openui-lang/quickstart.mdx b/docs/content/docs/openui-lang/quickstart.mdx
index 37685b0c2..459371d1e 100644
--- a/docs/content/docs/openui-lang/quickstart.mdx
+++ b/docs/content/docs/openui-lang/quickstart.mdx
@@ -198,7 +198,7 @@ const RecipeRemix = defineComponent({
// eslint-disable-next-line @next/next/no-img-element
<img
src={recipe.imageUrl}
- alt=""
+ alt={recipe.title}
onError={(event) => (event.currentTarget.hidden = true)}
style={{ display: "block", width: "100%", height: "100%", objectFit: "cover" }}
/>