feat(timeline): per-year hub redesign + SEO/AEO

.gitignore

@@ -17,6 +17,7 @@ llmgateway_data
 .claude/scheduled_tasks.lock
 *.http
 *.txt
+!apps/ui/public/llms.txt
 docker-compose-override-*.yml
 benchmark_results.json
 *.pdf

apps/ui/next.config.ts

@@ -117,10 +117,8 @@ const nextConfig: NextConfig = {
 	},
 	async rewrites() {
 		return [
-			{
-				source: "/llms.txt",
-				destination: "https://docs.llmgateway.io/llms.txt",
-			},
+			// /llms.txt is served as a static file from public/ (which takes
+			// precedence over rewrites), so it is intentionally not proxied here.
 			{
 				source: "/llms-full.txt",
 				destination: "https://docs.llmgateway.io/llms-full.txt",

apps/ui/public/llms.txt

@@ -0,0 +1,17 @@
+# LLM Gateway
+
+> LLM Gateway is a unified API for routing requests across OpenAI, Anthropic, Google, Meta, Mistral, DeepSeek and 35+ other LLM providers. Use one OpenAI-compatible API and one key to access every model, with usage analytics, cost tracking, caching, and automatic failover. Open source (AGPLv3) and self-hostable.
+
+## Key pages
+
+- [Models](https://llmgateway.io/models): Full catalog of supported LLMs with pricing, context windows, and capabilities.
+- [Model release timeline](https://llmgateway.io/timeline): When each LLM was released by its provider and when it was added to LLM Gateway — a reference for AI model release dates (GPT, Claude, Gemini, Llama, Mistral, DeepSeek).
+- [Pricing](https://llmgateway.io/pricing): Pay-as-you-go credits with a 5% platform fee, free Bring-Your-Own-Keys, and enterprise plans.
+- [Providers](https://llmgateway.io/providers): Every supported provider and the models each offers.
+- [Docs](https://docs.llmgateway.io): API reference and integration guides.
+- [Compare](https://llmgateway.io/compare/open-router): How LLM Gateway compares to OpenRouter, LiteLLM, Portkey, and the Vercel AI Gateway.
+
+## Notes
+
+- New models are typically available within 48 hours of their provider release.
+- The API is OpenAI-compatible; point your existing SDK at the gateway base URL.

apps/ui/src/app/sitemap.ts

@@ -20,6 +20,46 @@ function slugify(label: string) {
 // "changed just now" on every crawl, which trains search engines to ignore it.
 const buildDate = new Date();
 
+// Most recent provider release date across the catalog. Used as the timeline
+// page's `lastModified` so it reflects real content freshness (a new model)
+// rather than the deploy time.
+const latestModelReleaseDate = (() => {
+	let latest = new Date(0);
+	for (const model of modelDefinitions) {
+		if ("releasedAt" in model && model.releasedAt) {
+			const date = new Date(model.releasedAt);
+			if (!Number.isNaN(date.getTime()) && date.getTime() > latest.getTime()) {
+				latest = date;
+			}
+		}
+	}
+	return latest.getTime() === 0 ? buildDate : latest;
+})();
+
+// Distinct release years across the catalog plus the latest release date within
+// each year, used to emit /timeline/{year} hub children. Using the per-year
+// latest release as `lastModified` keeps historical year pages from reporting a
+// change on every deploy.
+const timelineYears = (() => {
+	const latestByYear = new Map<number, Date>();
+	for (const model of modelDefinitions) {
+		if ("releasedAt" in model && model.releasedAt) {
+			const date = new Date(model.releasedAt);
+			if (Number.isNaN(date.getTime())) {
+				continue;
+			}
+			const year = date.getUTCFullYear();
+			const current = latestByYear.get(year);
+			if (!current || date.getTime() > current.getTime()) {
+				latestByYear.set(year, date);
+			}
+		}
+	}
+	return Array.from(latestByYear.entries())
+		.map(([year, lastModified]) => ({ year, lastModified }))
+		.sort((a, b) => b.year - a.year);
+})();
+
 export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
 	const baseUrl = "https://llmgateway.io";
 
@@ -102,9 +142,9 @@ export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
 		},
 		{
 			url: `${baseUrl}/timeline`,
-			lastModified: buildDate,
-			changeFrequency: "monthly",
-			priority: 0.5,
+			lastModified: latestModelReleaseDate,
+			changeFrequency: "weekly",
+			priority: 0.8,
 		},
 		{
 			url: `${baseUrl}/brand`,
@@ -399,8 +439,20 @@ export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
 			priority: 0.7,
 		}));
 
+	// Per-year timeline hub children (/timeline/{year})
+	const currentYear = buildDate.getFullYear();
+	const timelineYearPages: MetadataRoute.Sitemap = timelineYears.map(
+		({ year, lastModified }) => ({
+			url: `${baseUrl}/timeline/${year}`,
+			lastModified,
+			changeFrequency: year === currentYear ? "weekly" : "monthly",
+			priority: year === currentYear ? 0.7 : 0.6,
+		}),
+	);
+
 	return [
 		...staticPages,
+		...timelineYearPages,
 		...modelPages,
 		...providerPages,
 		...featurePages,

apps/ui/src/app/timeline/[year]/opengraph-image.tsx

@@ -0,0 +1,146 @@
+import { ImageResponse } from "next/og";
+
+import { models as modelDefinitions } from "@llmgateway/models";
+
+export const size = {
+	width: 1200,
+	height: 630,
+};
+
+export const contentType = "image/png";
+
+export const alt = "AI model release timeline by year — LLM Gateway";
+
+interface ImageProps {
+	params: Promise<{ year: string }>;
+}
+
+export default async function TimelineYearOgImage({ params }: ImageProps) {
+	const { year } = await params;
+
+	const count = modelDefinitions.filter((model) => {
+		if (!("releasedAt" in model) || !model.releasedAt) {
+			return false;
+		}
+		const date = new Date(model.releasedAt);
+		return (
+			!Number.isNaN(date.getTime()) && String(date.getUTCFullYear()) === year
+		);
+	}).length;
+
+	return new ImageResponse(
+		(
+			<div
+				style={{
+					width: "100%",
+					height: "100%",
+					display: "flex",
+					flexDirection: "column",
+					justifyContent: "space-between",
+					background: "#000000",
+					backgroundImage:
+						"radial-gradient(60% 70% at 50% 0%, rgba(56,189,248,0.18) 0%, rgba(0,0,0,0) 70%)",
+					color: "white",
+					fontFamily:
+						"system-ui, -apple-system, BlinkMacSystemFont, sans-serif",
+					padding: 64,
+					boxSizing: "border-box",
+				}}
+			>
+				<div
+					style={{
+						display: "flex",
+						flexDirection: "row",
+						alignItems: "center",
+						gap: 18,
+					}}
+				>
+					<svg
+						fill="none"
+						xmlns="http://www.w3.org/2000/svg"
+						viewBox="0 0 218 232"
+						width={56}
+						height={56}
+					>
+						<path
+							d="M218 59.4686c0-4.1697-2.351-7.9813-6.071-9.8441L119.973 3.58361s2.926 3.32316 2.926 7.01529V218.833c0 4.081-2.926 7.016-2.926 7.016l15.24-7.468c2.964-2.232 7.187-7.443 7.438-16.006.293-9.976.61-84.847.732-121.0353.487-3.6678 4.096-11.0032 14.63-11.0032 10.535 0 29.262 5.1348 37.309 7.7022 2.439.7336 7.608 4.1812 8.779 12.1036 1.17 7.9223.975 59.0507.731 83.6247 0 2.445.137 7.069 6.653 7.069 6.515 0 6.515-7.069 6.515-7.069V59.4686Z"
+							fill="#ffffff"
+						/>
+						<path
+							d="M149.235 86.323c0-5.5921 5.132-9.7668 10.589-8.6132l31.457 6.6495c4.061.8585 6.967 4.4207 6.967 8.5824v81.9253c0 5.868 5.121 9.169 5.121 9.169l-51.9-12.658c-1.311-.32-2.234-1.498-2.234-2.852V86.323ZM99.7535 1.15076c7.2925-3.60996 15.8305 1.71119 15.8305 9.86634V220.983c0 8.155-8.538 13.476-15.8305 9.866L6.11596 184.496C2.37105 182.642 0 178.818 0 174.63v-17.868l49.7128 19.865c4.0474 1.617 8.4447-1.372 8.4449-5.741 0-2.66-1.6975-5.022-4.2142-5.863L0 146.992v-14.305l40.2756 7.708c3.9656.759 7.6405-2.289 7.6405-6.337 0-3.286-2.4628-6.048-5.7195-6.413L0 122.917V108.48l78.5181-3.014c4.1532-.16 7.4381-3.582 7.4383-7.7498 0-4.6256-4.0122-8.2229-8.5964-7.7073L0 98.7098V82.4399l53.447-17.8738c2.3764-.7948 3.9791-3.0254 3.9792-5.5374 0-4.0961-4.0978-6.9185-7.9106-5.4486L0 72.6695V57.3696c.0000304-4.1878 2.37107-8.0125 6.11596-9.8664L99.7535 1.15076Z"
+							fill="#ffffff"
+						/>
+					</svg>
+					<div
+						style={{
+							display: "flex",
+							flexDirection: "row",
+							alignItems: "center",
+							gap: 12,
+							fontSize: 30,
+							color: "#9CA3AF",
+						}}
+					>
+						<span style={{ color: "#ffffff", fontWeight: 600 }}>
+							LLM Gateway
+						</span>
+						<span style={{ opacity: 0.5 }}>•</span>
+						<span>Release Timeline</span>
+					</div>
+				</div>
+
+				<div
+					style={{
+						display: "flex",
+						flexDirection: "column",
+						gap: 16,
+						maxWidth: 980,
+					}}
+				>
+					<h1
+						style={{
+							fontSize: 92,
+							fontWeight: 700,
+							margin: 0,
+							letterSpacing: "-0.03em",
+							lineHeight: 1.02,
+						}}
+					>
+						AI models released in {year}
+					</h1>
+					<p
+						style={{
+							fontSize: 32,
+							margin: 0,
+							color: "#9CA3AF",
+							lineHeight: 1.3,
+						}}
+					>
+						Provider release dates for every {year} LLM — and when each landed
+						on LLM Gateway.
+					</p>
+				</div>
+
+				<div
+					style={{
+						display: "flex",
+						flexDirection: "row",
+						alignItems: "flex-end",
+						justifyContent: "space-between",
+					}}
+				>
+					<div style={{ display: "flex", flexDirection: "column", gap: 4 }}>
+						<span style={{ fontSize: 56, fontWeight: 700 }}>{count}</span>
+						<span style={{ fontSize: 26, color: "#9CA3AF" }}>
+							models released in {year}
+						</span>
+					</div>
+					<span style={{ fontSize: 26, color: "#9CA3AF" }}>
+						llmgateway.io/timeline/{year}
+					</span>
+				</div>
+			</div>
+		),
+		size,
+	);
+}