chore(site): seo improvements (#4157)

# Description

Please include a summary of the changes and the related issue. Please also include relevant motivation and context.

## Type of change

- [ ] Bug fix (non-breaking change which fixes an issue)
- [ ] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
- [ ] This change requires a documentation update

## How Has This Been Tested?

Please describe the tests that you ran to verify your changes.

## Checklist:

- [ ] My code follows the style guidelines of this project
- [ ] I have performed a self-review of my code
- [ ] I have commented my code, particularly in hard-to-understand areas
- [ ] I have made corresponding changes to the documentation
- [ ] My changes generate no new warnings
- [ ] I have added tests that prove my fix is effective or that my feature works
- [ ] New and existing unit tests pass locally with my changes

Author: NicholasKissel

examples/hono-vercel/README.md

@@ -14,6 +14,32 @@ export default defineConfig({
 	site: 'https://rivet.dev',
 	output: 'static',
 	trailingSlash: 'ignore',
+	// SEO Redirects - Astro generates HTML redirect files for static builds
+	// These work in dev server and all deployment platforms (Vercel, Netlify, Cloudflare, etc.)
+	redirects: {
+		// Documentation restructure
+		'/docs/setup': '/docs/actors/quickstart/',
+		'/docs/actors/queues': '/docs/actors/queue/',
+		'/docs/actors/websockets': '/docs/actors/websocket-handler/',
+		'/docs/actors/http': '/docs/actors/http-api/',
+		'/docs/actors/run': '/docs/actors/lifecycle/',
+		'/docs/actors/scheduling': '/docs/actors/schedule/',
+		// Platform docs moved to clients/connect
+		'/docs/platforms/react': '/docs/clients/react/',
+		'/docs/platforms/next-js': '/docs/clients/javascript/',
+		'/docs/platforms/cloudflare-workers': '/docs/connect/cloudflare-workers/',
+		// Registry configuration moved
+		'/docs/connect/registry-configuration': '/docs/general/registry-configuration/',
+		// Cloud docs removed - redirect to relevant sections
+		'/docs/cloud': '/docs/self-hosting/',
+		'/docs/cloud/api/actors/create': '/docs/actors/',
+		'/docs/cloud/api/routes/update': '/docs/actors/',
+		'/docs/cloud/self-hosting/single-container': '/docs/self-hosting/docker-container/',
+		// Next.js client redirect (linked from homepage)
+		'/docs/clients/next-js': '/docs/clients/javascript/',
+		// Self-hosting redirect
+		'/docs/general/self-hosting': '/docs/self-hosting/',
+	},
 	prefetch: {
 		prefetchAll: true,
 		defaultStrategy: 'hover',

examples/hono/README.md

@@ -2,9 +2,10 @@
 User-agent: *
 Allow: /
 
-# Sitemap
-Sitemap: https://rivet.dev/sitemap.xml
-
-# Disallow API and internal routes
+# Disallow API, internal routes, and TypeDoc (generic meta descriptions)
 Disallow: /api/
 Disallow: /internal/
+Disallow: /typedoc/
+
+# Sitemap
+Sitemap: https://rivet.dev/sitemap-index.xml

website/astro.config.mjs

@@ -368,8 +368,8 @@ TODO: copy the rest of this from low-level webosckets document and rephrase
 ### networking
 
 - actors may live in different regions than inbound requests
-- rive tuses the Epoxy (link again) system to handle global routing to route traffic to the correct region with high performance
-- this is completely transparent to you. your app sends traffic to https://api.rivet.dev/gatewa/* and it automatically routes to the correct actor in the appropirate region
+- Rivet uses the Epoxy (link again) system to handle global routing to route traffic to the correct region with high performance
+- this is completely transparent to you. your app sends traffic to https://api.rivet.dev/gateway/* and it automatically routes to the correct actor in the appropriate region
 
 ### globally unique actor keys
 

website/public/robots.txt

@@ -18,8 +18,13 @@ interface Props {
 	ogType?: string;
 	publishedTime?: string;
 	keywords?: string[];
+	articleAuthor?: string;
+	articleSection?: string;
+	robots?: string;
 }
 
+const DEFAULT_KEYWORDS = ["rivet", "actors", "serverless", "backend", "real-time", "stateful", "websockets"];
+
 const {
 	title,
 	description = "Rivet Actors are long-lived stateful processes with built-in state, storage, workflows, scheduling, WebSockets, and more. Open source and self-hostable.",
@@ -28,29 +33,51 @@ const {
 	ogType = "website",
 	publishedTime,
 	keywords,
+	articleAuthor,
+	articleSection,
+	robots,
 } = Astro.props;
 
+// Normalize keywords to lowercase for consistency
+const effectiveKeywords = Array.isArray(keywords)
+	? keywords.map(k => k.toLowerCase())
+	: DEFAULT_KEYWORDS;
+
+// Only add " - Rivet" suffix if not already present (handles Rivet, Rivet Actors, Rivet Templates)
+const formattedTitle = !title
+	? 'Rivet'
+	: / - Rivet( Actors| Templates)?$/.test(title)
+		? title
+		: `${title} - Rivet`;
+
 const siteUrl = import.meta.env.PUBLIC_SITE_URL || 'https://rivet.dev';
 
 // Auto-generate canonical URL from current page path if not explicitly provided
 const currentPath = Astro.url.pathname;
 const effectiveCanonicalUrl = canonicalUrl || `https://rivet.dev${currentPath}`;
+
+// RSS feed is only relevant for blog and changelog pages
+const showRssFeed = currentPath.startsWith('/blog') || currentPath.startsWith('/changelog');
 ---
 
 <!DOCTYPE html>
 <html lang="en" class="dark">
 	<head>
 		<meta charset="utf-8" />
 		<meta name="viewport" content="width=device-width, initial-scale=1.0" />
-		<title>{title}</title>
+		<title>{formattedTitle}</title>
 		<meta name="description" content={description} />
+		<meta http-equiv="content-language" content="en" />
+		{robots && <meta name="robots" content={robots} />}
+		<meta name="keywords" content={effectiveKeywords.join(', ')} />
 
 		<link rel="canonical" href={effectiveCanonicalUrl} />
+		{showRssFeed && <link rel="alternate" type="application/rss+xml" title="Rivet Blog" href="/rss/feed.xml" />}
 
 		<!-- Twitter -->
 		<meta name="twitter:site" content="@rivet_dev" />
 		<meta name="twitter:card" content="summary_large_image" />
-		<meta name="twitter:title" content={title} />
+		<meta name="twitter:title" content={formattedTitle} />
 		<meta name="twitter:description" content={description} />
 		<meta name="twitter:image" content={ogImage} />
 
@@ -59,14 +86,16 @@ const effectiveCanonicalUrl = canonicalUrl || `https://rivet.dev${currentPath}`;
 		<meta property="og:locale" content="en_US" />
 		<meta property="og:url" content={effectiveCanonicalUrl} />
 		<meta property="og:site_name" content="Rivet" />
-		<meta property="og:title" content={title} />
+		<meta property="og:title" content={formattedTitle} />
 		<meta property="og:description" content={description} />
 		<meta property="og:image" content={ogImage} />
+		<meta property="og:image:alt" content={title ? `${title} - Rivet Actors` : 'Rivet Actors'} />
 		<meta property="og:image:width" content="1200" />
 		<meta property="og:image:height" content="630" />
 		{publishedTime && <meta property="article:published_time" content={publishedTime} />}
-
-		{keywords && <meta name="keywords" content={keywords.join(', ')} />}
+		{articleAuthor && <meta property="article:author" content={articleAuthor} />}
+		{articleSection && <meta property="article:section" content={articleSection} />}
+		{Array.isArray(keywords) && keywords.map((keyword) => <meta property="article:tag" content={keyword.toLowerCase()} />)}
 
 		<!-- JSON-LD Structured Data -->
 		<script type="application/ld+json" set:html={JSON.stringify({

website/src/content/docs/general/architecture.mdx

@@ -11,9 +11,14 @@ interface Props {
 	modifiedTime?: string;
 	keywords?: string[];
 	authorName?: string;
+	authorSocials?: { twitter?: string; github?: string; bluesky?: string };
+	category?: string;
 }
 
-const { title, description, canonicalUrl, ogImage, publishedTime, modifiedTime, keywords, authorName } = Astro.props;
+const { title, description, canonicalUrl, ogImage, publishedTime, modifiedTime, keywords, authorName, authorSocials, category } = Astro.props;
+
+// Build sameAs array from author socials
+const authorSameAs = authorSocials ? Object.values(authorSocials).filter(Boolean) : [];
 
 const articleSchema = {
 	"@context": "https://schema.org",
@@ -25,7 +30,8 @@ const articleSchema = {
 	"dateModified": modifiedTime || publishedTime,
 	"author": {
 		"@type": "Person",
-		"name": authorName || "Rivet Team"
+		"name": authorName || "Rivet Team",
+		...(authorSameAs.length > 0 && { "sameAs": authorSameAs })
 	},
 	"publisher": {
 		"@type": "Organization",
@@ -52,6 +58,8 @@ const articleSchema = {
 	ogType="article"
 	publishedTime={publishedTime}
 	keywords={keywords}
+	articleAuthor={authorName}
+	articleSection={category}
 >
 	<script type="application/ld+json" set:html={JSON.stringify(articleSchema)} />
 	<Header active="blog" variant="floating" client:load />

website/src/layouts/BaseLayout.astro

@@ -105,6 +105,8 @@ const breadcrumbSchema = {
 	publishedTime={entry.data.published.toISOString()}
 	keywords={entry.data.keywords}
 	authorName={author.name}
+	authorSocials={author.socials}
+	category={category.name}
 >
 	<script type="application/ld+json" set:html={JSON.stringify(breadcrumbSchema)} />
 	<div

website/src/layouts/BlogLayout.astro

@@ -91,6 +91,8 @@ const otherArticles = filteredOtherPosts.map((post) => {
 	publishedTime={entry.data.published.toISOString()}
 	keywords={entry.data.keywords}
 	authorName={author.name}
+	authorSocials={author.socials}
+	category={category.name}
 >
 	<div class="mx-auto mt-20 w-full max-w-6xl px-4 md:mt-32" style="--header-height: 5rem;">
 		<ul class="text-muted-foreground my-4 flex flex-wrap items-center gap-2 text-xs">

website/src/pages/blog/[...slug].astro

@@ -1,12 +1,67 @@
 ---
 import MarketingLayout from '@/layouts/MarketingLayout.astro';
 import PricingPageClient from '@/components/marketing/pricing/PricingPageClient';
+
+// Product schema with pricing tiers
+const productSchema = {
+	"@context": "https://schema.org",
+	"@type": "Product",
+	"name": "Rivet Cloud",
+	"description": "Managed cloud solution for stateful backends. Global infrastructure, persistent state, and seamless orchestration for your actors.",
+	"brand": {
+		"@type": "Brand",
+		"name": "Rivet"
+	},
+	"url": "https://rivet.dev/cloud/",
+	"image": "https://rivet.dev/promo/og.png",
+	"category": "Cloud Computing Platform",
+	"offers": [
+		{
+			"@type": "Offer",
+			"name": "Free",
+			"description": "For prototyping and small projects. 100,000 Awake Actor Hours, 5GB storage, community support.",
+			"price": "0",
+			"priceCurrency": "USD",
+			"priceValidUntil": "2027-12-31",
+			"availability": "https://schema.org/InStock",
+			"url": "https://dashboard.rivet.dev"
+		},
+		{
+			"@type": "Offer",
+			"name": "Hobby",
+			"description": "For scaling applications. 400,000 Awake Actor Hours included, 25 Billion reads/month, email support.",
+			"price": "20",
+			"priceCurrency": "USD",
+			"priceValidUntil": "2027-12-31",
+			"availability": "https://schema.org/InStock",
+			"url": "https://dashboard.rivet.dev"
+		},
+		{
+			"@type": "Offer",
+			"name": "Team",
+			"description": "For growing teams and businesses. 400,000 Awake Actor Hours included, MFA, Slack support.",
+			"price": "200",
+			"priceCurrency": "USD",
+			"priceValidUntil": "2027-12-31",
+			"availability": "https://schema.org/InStock",
+			"url": "https://dashboard.rivet.dev"
+		},
+		{
+			"@type": "Offer",
+			"name": "Enterprise",
+			"description": "For high-volume, mission-critical workloads. Priority support, SLA, OIDC SSO, audit logs, custom roles.",
+			"availability": "https://schema.org/InStock",
+			"url": "https://rivet.dev/sales/"
+		}
+	]
+};
 ---
 
 <MarketingLayout
 	title="Cloud - Rivet"
 	description="Rivet Cloud—managed cloud solution for stateful backends. Transparent pricing, global infrastructure, and seamless orchestration."
 	canonicalUrl="https://rivet.dev/cloud/"
 >
+	<script type="application/ld+json" set:html={JSON.stringify(productSchema)} />
 	<PricingPageClient client:load />
 </MarketingLayout>