feat(seo): add JSON-LD, OG images and RSS feed for news

src/app/(site)/news/rss.xml/route.ts

@@ -0,0 +1,25 @@
+import { resolveHotelName } from "@/lib/hotel-name";
+import { buildNewsRss } from "@/lib/news-rss";
+import { appBaseUrl } from "@/lib/seo";
+import { getNewsList } from "@/lib/services/news-list";
+
+// Built per request so the feed never needs a database connection during
+// `next build`, matching the sitemap and robots routes.
+export const dynamic = "force-dynamic";
+
+export async function GET() {
+	const [hotelName, items] = await Promise.all([
+		resolveHotelName(),
+		getNewsList(30),
+	]);
+
+	return new Response(
+		buildNewsRss(items, { hotelName, appUrl: appBaseUrl() }),
+		{
+			headers: {
+				"Content-Type": "application/rss+xml; charset=utf-8",
+				"Cache-Control": "public, s-maxage=300, stale-while-revalidate=600",
+			},
+		},
+	);
+}

src/app/(site)/page.tsx

@@ -11,6 +11,7 @@ import { AuthTopBar } from "@/components/auth/auth-top-bar";
 import { LoginForm } from "@/components/auth/login-form";
 import Link from "@/components/link";
 import { Reveal } from "@/components/motion-reveal";
+import { JsonLd } from "@/components/public/json-ld";
 import { PublicLoadError } from "@/components/public/load-error";
 import { UserAvatarThumbnail } from "@/components/shared/user-avatar-thumbnail";
 import { SpotlightCard } from "@/components/spotlight-card";
@@ -21,6 +22,11 @@ import { CameraWeb, db, User } from "@/lib/db";
 import { formatDate } from "@/lib/format-date";
 import { resolveHotelName } from "@/lib/hotel-name";
 import { withPublicPagePerformance } from "@/lib/public-page-performance";
+import {
+	absoluteAssetUrl,
+	appBaseUrl,
+	buildWebsiteStructuredData,
+} from "@/lib/seo";
 import { captchaConfig } from "@/lib/services/captcha";
 import { getNewsList } from "@/lib/services/news-list";
 import { loadProfilePrivacyMap } from "@/lib/services/profile-privacy";
@@ -48,10 +54,15 @@ export async function generateMetadata(): Promise<Metadata> {
 	const tp = await getTranslations("pages.home");
 	const title = tn("home");
 	const description = tp("welcomeBody");
+	const appUrl = appBaseUrl();
 	return {
 		title,
 		description,
-		openGraph: { title, description, type: "website" },
+		alternates: {
+			canonical: appUrl,
+			types: { "application/rss+xml": `${appUrl}/news/rss.xml` },
+		},
+		openGraph: { title, description, type: "website", url: appUrl },
 	};
 }
 
@@ -442,6 +453,7 @@ async function Home() {
 	const exploreLinks = [
 		{ href: "/community", label: tn("community") },
 		{ href: "/news", label: tn("articles") },
+		{ href: "/events", label: tn("events") },
 		{ href: "/photos", label: tn("photos") },
 		{ href: "/radio", label: tn("radio") },
 		{ href: "/shop", label: tn("shop") },
@@ -460,8 +472,15 @@ async function Home() {
 		{ value: articleCount, label: tp("statsArticles"), icon: ICON_ARTICLE },
 	];
 
+	const structuredData = buildWebsiteStructuredData({
+		hotelName,
+		url: appBaseUrl(),
+		logo: absoluteAssetUrl(logo, appBaseUrl()),
+	});
+
 	return (
 		<div className="flex w-full flex-col gap-14 pb-16 pt-2 md:gap-20 md:pb-24">
+			<JsonLd data={structuredData} />
 			{/* ── Top bar: logo + live online + language/clock/theme ── */}
 			<div className="mx-auto w-full max-w-7xl">
 				<AuthTopBar hotelName={hotelName} logo={logo} online={online} />

src/app/layout.tsx

@@ -38,7 +38,10 @@ const pixelify = Pixelify_Sans({
 // export const instant = false;
 
 export async function generateMetadata(): Promise<Metadata> {
-	const appUrl = process.env.APP_URL ?? "http://localhost:3000";
+	const appUrl = (process.env.APP_URL ?? "http://localhost:3000").replace(
+		/\/+$/,
+		"",
+	);
 	const hotel = await resolveHotelName();
 	const customFavicon = await siteSettings.get("cms_favicon");
 	const faviconUrl = customFavicon ?? getDefaultFaviconDataUri();
@@ -50,15 +53,28 @@ export async function generateMetadata(): Promise<Metadata> {
 		title: { default: `${hotel} - Hotel`, template: `%s · ${hotel}` },
 		description: `${hotel} — a Habbo retro hotel. Hang out, collect furni and meet friends.`,
 		metadataBase: new URL(appUrl),
-		alternates: { canonical: appUrl },
+		alternates: {
+			canonical: appUrl,
+			types: { "application/rss+xml": `${appUrl}/news/rss.xml` },
+		},
 		icons,
 		openGraph: {
 			title: `${hotel} - Hotel`,
 			description: `${hotel} — a Habbo retro hotel. Hang out, collect furni and meet friends.`,
 			type: "website",
 			siteName: hotel,
+			images: [
+				{
+					url: `${appUrl}/assets/images/next_header.jpg`,
+					alt: `${hotel} - Hotel`,
+				},
+			],
+		},
+		twitter: {
+			card: "summary_large_image",
+			title: `${hotel} - Hotel`,
+			images: [`${appUrl}/assets/images/next_header.jpg`],
 		},
-		twitter: { card: "summary_large_image", title: `${hotel} - Hotel` },
 	};
 }
 

src/components/public/json-ld.tsx

@@ -0,0 +1,21 @@
+/**
+ * Renders schema.org JSON-LD. The payload is data, not executable script, but
+ * `<` is escaped so an article title can never terminate the tag early.
+ */
+export function JsonLd({
+	data,
+	nonce,
+}: {
+	data: Record<string, unknown> | Record<string, unknown>[];
+	nonce?: string;
+}) {
+	return (
+		<script
+			type="application/ld+json"
+			nonce={nonce}
+			dangerouslySetInnerHTML={{
+				__html: JSON.stringify(data).replace(/</g, "\\u003c"),
+			}}
+		/>
+	);
+}

src/lib/news-rss.ts

@@ -0,0 +1,72 @@
+import { absoluteAssetUrl, escapeXml } from "@/lib/seo";
+
+export interface NewsRssItem {
+	slug: string;
+	title: string;
+	shortStory: string;
+	image: string;
+	createdAt: Date | null;
+}
+
+function imageMime(url: string): string {
+	const extension = url.split("?")[0]?.split(".").pop()?.toLowerCase();
+	switch (extension) {
+		case "png":
+			return "image/png";
+		case "gif":
+			return "image/gif";
+		case "webp":
+			return "image/webp";
+		case "avif":
+			return "image/avif";
+		default:
+			return "image/jpeg";
+	}
+}
+
+/** Build a standards-compliant RSS 2.0 feed for the public news archive. */
+export function buildNewsRss(
+	items: NewsRssItem[],
+	options: { hotelName: string; appUrl: string; now?: Date },
+): string {
+	const base = options.appUrl.replace(/\/+$/, "");
+	const now = options.now ?? new Date();
+
+	const entries = items
+		.map((item) => {
+			const url = `${base}/news/${encodeURIComponent(item.slug)}`;
+			const image = absoluteAssetUrl(item.image, base);
+			return [
+				"<item>",
+				`<title>${escapeXml(item.title)}</title>`,
+				`<link>${escapeXml(url)}</link>`,
+				`<guid isPermaLink="true">${escapeXml(url)}</guid>`,
+				item.createdAt
+					? `<pubDate>${item.createdAt.toUTCString()}</pubDate>`
+					: "",
+				`<description>${escapeXml(item.shortStory)}</description>`,
+				image
+					? `<enclosure url="${escapeXml(image)}" type="${imageMime(image)}" length="0" />`
+					: "",
+				"</item>",
+			]
+				.filter(Boolean)
+				.join("");
+		})
+		.join("");
+
+	return [
+		'<?xml version="1.0" encoding="UTF-8"?>',
+		'<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">',
+		"<channel>",
+		`<title>${escapeXml(`${options.hotelName} — News`)}</title>`,
+		`<link>${escapeXml(`${base}/news`)}</link>`,
+		`<description>${escapeXml(`Latest news from ${options.hotelName}`)}</description>`,
+		"<language>en</language>",
+		`<atom:link href="${escapeXml(`${base}/news/rss.xml`)}" rel="self" type="application/rss+xml" />`,
+		`<lastBuildDate>${now.toUTCString()}</lastBuildDate>`,
+		entries,
+		"</channel>",
+		"</rss>",
+	].join("");
+}