Skip to content

🐸 Rybbit - open-source and privacy-friendly alternative to Google Analytics that is 10x more intuitive.

Blog template: optimized images, TOC, related posts, updated date, schema fixes; legacy redirects (#1195)

Goldflag39ba2f050fe6
diff --git a/docs/next.config.mjs b/docs/next.config.mjs
index 92a528b47..a148ebd20 100644
--- a/docs/next.config.mjs
+++ b/docs/next.config.mjs
@@ -63,11 +63,36 @@ const config = {
...['mastodon', 'medium'].map(p => `${p}-bio-generator`),
...['nostr', 'lemmy', 'warpcast', 'dribbble', 'mastodon', 'medium', 'vk', 'tumblr'].map(p => `${p}-photo-resizer`),
];
- return retiredSlugs.map(slug => ({
- source: `/tools/${slug}`,
- destination: '/tools',
- permanent: true,
- }));
+ // URLs that no longer exist but are still linked from old blog posts, external
+ // sites and the search index. Specific rules must precede the catch-alls.
+ const legacyRedirects = [
+ // Docs reorganisation: behavior-analytics/* and product-analytics/* moved.
+ ['/docs/behavior-analytics/:path*', '/docs/feature-guides/:path*'],
+ ['/docs/product-analytics/funnels_guide', '/docs/funnels'],
+ ['/docs/product-analytics/journeys_dashboard', '/docs/feature-guides/journeys'],
+ ['/docs/product-analytics/retention_guide', '/docs/feature-guides/retention'],
+ ['/docs/product-analytics/:path*', '/docs'],
+ ['/docs/web-analytics/goals-tab', '/docs/goals'],
+ ['/docs/web-analytics/:path*', '/docs/feature-guides/main-tab'],
+ ['/docs/getting-started/:path*', '/docs'],
+ ['/docs/blog/:path*', '/blog/:path*'],
+ // Blog posts deleted before redirects existed; they still get visits and backlinks.
+ ['/blog/data-privacy-2025', '/security'],
+ ['/blog/master-digital-marketing', '/blog'],
+ ['/blog/boost-growth-with-key-user-retention-metrics', '/features/retention'],
+ ['/blog/replay-session', '/features/session-replay'],
+ ['/blog/real-time-reports', '/features/web-analytics'],
+ ['/blog/cross-site-tracking', '/features/web-analytics'],
+ ['/blog/user-flow-examples-2025', '/features/user-journeys'],
+ ];
+ return [
+ ...retiredSlugs.map(slug => ({
+ source: `/tools/${slug}`,
+ destination: '/tools',
+ permanent: true,
+ })),
+ ...legacyRedirects.map(([source, destination]) => ({ source, destination, permanent: true })),
+ ];
},
async rewrites() {
return [
diff --git a/docs/source.config.ts b/docs/source.config.ts
index b761218ec..be8b04db9 100644
--- a/docs/source.config.ts
+++ b/docs/source.config.ts
@@ -32,6 +32,8 @@ export const blog = defineDocs({
docs: {
schema: frontmatterSchema.extend({
date: z.string().date().or(z.date()),
+ // Set when a post is substantially revised; drives "Updated", dateModified and the sitemap.
+ updated: z.string().date().or(z.date()).optional(),
author: z.string().optional(),
image: z.string().optional(),
tags: z.array(z.string()).optional(),
diff --git a/docs/src/app/[locale]/blog/[...slug]/page.tsx b/docs/src/app/[locale]/blog/[...slug]/page.tsx
index 86cf9f62b..42b102268 100644
--- a/docs/src/app/[locale]/blog/[...slug]/page.tsx
+++ b/docs/src/app/[locale]/blog/[...slug]/page.tsx
@@ -2,14 +2,23 @@ import { notFound } from "next/navigation";
import { blogSource } from "@/lib/blog-source";
import Link from "next/link";
import Image from "next/image";
-import { ChevronLeft } from "lucide-react";
+import { ArrowRight, ChevronLeft } from "lucide-react";
import type { Metadata } from "next";
import defaultMdxComponents from "fumadocs-ui/mdx";
import { Pre } from "fumadocs-ui/components/codeblock";
+import { InlineTOC } from "fumadocs-ui/components/inline-toc";
import Script from "next/script";
import { CTASection } from "@/components/CTASection";
import { GridCrosses } from "@/components/GridCrosses";
-import { createOGImageUrl } from "@/lib/metadata";
+import {
+ absoluteUrl,
+ isGeneratedImage,
+ postImageUrl,
+ readingTimeMinutes,
+ relatedPosts,
+ wordCount,
+ type BlogPost,
+} from "@/lib/blog";
export function generateStaticParams() {
return blogSource.getPages().map(page => ({
@@ -17,6 +26,14 @@ export function generateStaticParams() {
}));
}
+function formatDate(date: Date) {
+ return date.toLocaleDateString("en-US", {
+ year: "numeric",
+ month: "long",
+ day: "numeric",
+ });
+}
+
export async function generateMetadata(props: { params: Promise<{ slug: string[] }> }): Promise<Metadata> {
const params = await props.params;
const page = blogSource.getPage(params.slug);
@@ -24,8 +41,8 @@ export async function generateMetadata(props: { params: Promise<{ slug: string[]
const url = `https://rybbit.com/blog/${params.slug.join("/")}`;
const publishedTime = page.data.date ? new Date(page.data.date).toISOString() : undefined;
- const ogImage =
- page.data.image || createOGImageUrl(page.data.title, page.data.description, "Blog").url;
+ const modifiedTime = page.data.updated ? new Date(page.data.updated).toISOString() : publishedTime;
+ const ogImage = postImageUrl(page);
return {
title: page.data.title,
@@ -38,6 +55,7 @@ export async function generateMetadata(props: { params: Promise<{ slug: string[]
description: page.data.description,
type: "article",
publishedTime,
+ modifiedTime,
authors: page.data.author ? [page.data.author] : undefined,
url,
images: [
@@ -65,6 +83,63 @@ export async function generateMetadata(props: { params: Promise<{ slug: string[]
};
}
+const DefaultMdxImage = defaultMdxComponents.img;
+
+/**
+ * Markdown images get width/height (and a static import) from fumadocs' remark-image
+ * plugin and go through next/image. Raw `<img>` tags in MDX arrive without
+ * dimensions, so they render as a plain lazy-loaded image instead of throwing.
+ */
+function MdxImage(props: React.ComponentProps<typeof DefaultMdxImage>) {
+ const { src, width, height } = props as { src?: unknown; width?: unknown; height?: unknown };
+ if (typeof src === "string" && !(width && height)) {
+ const { alt, ...rest } = props as React.ComponentProps<"img">;
+ // eslint-disable-next-line @next/next/no-img-element
+ return <img alt={alt ?? ""} loading="lazy" decoding="async" {...rest} />;
+ }
+ return <DefaultMdxImage {...props} />;
+}
+
+function RelatedPostCard({ post }: { post: BlogPost }) {
+ const image = postImageUrl(post);
+ const date = post.data.date ? new Date(post.data.date) : null;
+ return (
+ <li className="border-b border-neutral-200 last:border-b-0 dark:border-neutral-800 md:border-b-0 md:border-r md:last:border-r-0">
+ <Link
+ href={`/blog/${post.slugs.join("/")}`}
+ className="group flex h-full flex-col gap-4 px-5 py-6 transition-colors duration-200 hover:bg-neutral-50 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-emerald-500 dark:hover:bg-neutral-900/40 sm:px-8 lg:px-10"
+ >
+ <Image
+ src={image}
+ alt=""
+ width={1200}
+ height={630}
+ unoptimized={isGeneratedImage(image)}
+ sizes="(max-width: 768px) 100vw, 380px"
+ className="aspect-[1200/630] w-full rounded-md border border-neutral-200 object-cover dark:border-neutral-800"
+ />
+ <div className="flex flex-1 flex-col gap-2">
+ {date && (
+ <time dateTime={date.toISOString()} className="text-xs text-neutral-500 tabular-nums dark:text-neutral-400">
+ {formatDate(date)}
+ </time>
+ )}
+ <h3 className="text-base font-semibold tracking-tight text-neutral-950 text-balance dark:text-neutral-50">
+ {post.data.title}
+ </h3>
+ <span className="mt-auto inline-flex items-center gap-1.5 pt-2 text-sm font-medium text-emerald-700 dark:text-emerald-400">
+ Read the post
+ <ArrowRight
+ className="size-3.5 transition-transform duration-200 group-hover:translate-x-0.5 motion-reduce:transition-none"
+ aria-hidden="true"
+ />
+ </span>
+ </div>
+ </Link>
+ </li>
+ );
+}
+
export default async function BlogPostPage(props: { params: Promise<{ slug: string[] }> }) {
const params = await props.params;
const page = blogSource.getPage(params.slug);
@@ -74,7 +149,14 @@ export default async function BlogPostPage(props: { params: Promise<{ slug: stri
}
const MDXContent = page.data.body;
+ const url = `https://rybbit.com/blog/${params.slug.join("/")}`;
const date = page.data.date ? new Date(page.data.date) : null;
+ const updated = page.data.updated ? new Date(page.data.updated) : null;
+ const minutes = readingTimeMinutes(page);
+ const related = relatedPosts(page, 3);
+ const coverImage = postImageUrl(page);
+ const authorName = page.data.author || "Rybbit Team";
+ const isTeamAuthor = /rybbit/i.test(authorName);
// Structured data for SEO
const structuredData = {
@@ -82,20 +164,24 @@ export default async function BlogPostPage(props: { params: Promise<{ slug: stri
"@type": "BlogPosting",
headline: page.data.title,
description: page.data.description,
+ image: [absoluteUrl(coverImage)],
datePublished: date?.toISOString(),
- dateModified: date?.toISOString(),
- author: {
- "@type": "Person",
- name: page.data.author || "Rybbit Team",
- },
+ dateModified: (updated ?? date)?.toISOString(),
+ author: isTeamAuthor
+ ? { "@type": "Organization", name: "Rybbit", url: "https://rybbit.com" }
+ : { "@type": "Person", name: authorName },
publisher: {
"@type": "Organization",
name: "Rybbit",
+ url: "https://rybbit.com",
logo: {
"@type": "ImageObject",
- url: "https://rybbit.com/public/rybbit.svg",
+ url: "https://rybbit.com/rybbit/horizontal_black.png",
},
},
+ mainEntityOfPage: { "@type": "WebPage", "@id": url },
+ wordCount: wordCount(page),
+ timeRequired: `PT${minutes}M`,
keywords: page.data.tags?.join(", "),
};
@@ -133,30 +219,35 @@ export default async function BlogPostPage(props: { params: Promise<{ slug: stri
</div>
<div className="flex flex-col justify-end gap-6 px-5 py-8 text-sm sm:px-8 lg:col-span-4 lg:px-10 lg:py-10">
- {(date || page.data.author) && (
- <dl className="grid grid-cols-2 gap-6">
- {date && (
- <div>
- <dt className="font-medium text-neutral-500 dark:text-neutral-400">Published</dt>
- <dd className="mt-1 text-neutral-950 tabular-nums dark:text-neutral-50">
- <time dateTime={date.toISOString()}>
- {date.toLocaleDateString("en-US", {
- year: "numeric",
- month: "long",
- day: "numeric",
- })}
- </time>
- </dd>
- </div>
- )}
- {page.data.author && (
- <div>
- <dt className="font-medium text-neutral-500 dark:text-neutral-400">Written by</dt>
- <dd className="mt-1 text-neutral-950 dark:text-neutral-50">{page.data.author}</dd>
- </div>
- )}
- </dl>
- )}
+ <dl className="grid grid-cols-2 gap-6">
+ {date && (
+ <div>
+ <dt className="font-medium text-neutral-500 dark:text-neutral-400">Published</dt>
+ <dd className="mt-1 text-neutral-950 tabular-nums dark:text-neutral-50">
+ <time dateTime={date.toISOString()}>{formatDate(date)}</time>
+ </dd>
+ </div>
+ )}
+
+ {updated && (
+ <div>
+ <dt className="font-medium text-neutral-500 dark:text-neutral-400">Updated</dt>
+ <dd className="mt-1 text-neutral-950 tabular-nums dark:text-neutral-50">
+ <time dateTime={updated.toISOString()}>{formatDate(updated)}</time>
+ </dd>
+ </div>
+ )}
+
+ <div>
+ <dt className="font-medium text-neutral-500 dark:text-neutral-400">Written by</dt>
+ <dd className="mt-1 text-neutral-950 dark:text-neutral-50">{authorName}</dd>
+ </div>
+
+ <div>
+ <dt className="font-medium text-neutral-500 dark:text-neutral-400">Reading time</dt>
+ <dd className="mt-1 text-neutral-950 tabular-nums dark:text-neutral-50">{minutes} min</dd>
+ </div>
+ </dl>
{page.data.tags && page.data.tags.length > 0 && (
<div>
@@ -185,21 +276,33 @@ export default async function BlogPostPage(props: { params: Promise<{ slug: stri
src={page.data.image}
alt={page.data.title}
width={1200}
- height={400}
+ height={630}
+ priority
+ sizes="(max-width: 1200px) 100vw, 1200px"
className="h-auto w-full object-cover"
/>
</div>
)}
<div className="px-5 py-10 sm:px-8 md:py-14 lg:px-10">
+ {page.data.toc.length >= 3 && (
+ <InlineTOC
+ items={page.data.toc}
+ defaultOpen
+ className="mb-8 max-w-3xl rounded-lg border border-neutral-200 dark:border-neutral-800"
+ />
+ )}
+
<div
className="prose prose-neutral max-w-3xl dark:prose-invert prose-headings:tracking-tight prose-a:text-emerald-700 prose-a:decoration-emerald-700/30 hover:prose-a:decoration-current dark:prose-a:text-emerald-400 dark:prose-a:decoration-emerald-400/30
prose-code:before:content-none prose-code:after:content-none
+ prose-img:rounded-lg prose-img:border prose-img:border-neutral-200 dark:prose-img:border-neutral-800
[&_pre]:my-4 [&_pre]:overflow-x-auto"
>
<MDXContent
components={{
...defaultMdxComponents,
+ img: MdxImage,
pre: (props: React.ComponentPropsWithoutRef<"pre">) => (
<Pre
{...props}
@@ -226,6 +329,28 @@ export default async function BlogPostPage(props: { params: Promise<{ slug: stri
</div>
</div>
</div>
+
+ {related.length > 0 && (
+ <section
+ aria-labelledby="related-posts"
+ className="border-b border-neutral-200 dark:border-neutral-800"
+ >
+ <div className="relative mx-auto max-w-[1200px] border-x border-neutral-200 dark:border-neutral-800">
+ <GridCrosses />
+ <h2
+ id="related-posts"
+ className="border-b border-neutral-200 px-5 py-5 text-sm font-semibold uppercase tracking-wide text-neutral-500 dark:border-neutral-800 dark:text-neutral-400 sm:px-8 lg:px-10"
+ >
+ Keep reading
+ </h2>
+ <ul className="grid md:grid-cols-3">
+ {related.map(post => (
+ <RelatedPostCard key={post.url} post={post} />
+ ))}
+ </ul>
+ </div>
+ </section>
+ )}
</article>
<CTASection eventLocation="blog_post_cta" />
diff --git a/docs/src/app/[locale]/blog/page.tsx b/docs/src/app/[locale]/blog/page.tsx
index b271a5ac7..b256ac339 100644
--- a/docs/src/app/[locale]/blog/page.tsx
+++ b/docs/src/app/[locale]/blog/page.tsx
@@ -1,9 +1,10 @@
import { ArrowRight } from "lucide-react";
import type { Metadata } from "next";
+import Image from "next/image";
import Link from "next/link";
import { GridCrosses } from "@/components/GridCrosses";
import { InteriorPageHero } from "@/components/InteriorPageHero";
-import { blogSource } from "@/lib/blog-source";
+import { isGeneratedImage, postImageUrl, readingTimeMinutes, sortedPosts, type BlogPost } from "@/lib/blog";
export const metadata: Metadata = {
title: "Blog — Web Analytics, Privacy & Open Source",
@@ -29,16 +30,25 @@ function formatDate(date: Date) {
});
}
-export default function BlogPage() {
- const posts = [...blogSource.getPages()];
-
- const sortedPosts = posts.sort((a, b) => {
- const dateA = new Date(a.data.date || 0);
- const dateB = new Date(b.data.date || 0);
- return dateB.getTime() - dateA.getTime();
- });
+function PostThumbnail({ post, priority = false, sizes }: { post: BlogPost; priority?: boolean; sizes: string }) {
+ const image = postImageUrl(post);
+ return (
+ <Image
+ src={image}
+ alt=""
+ width={1200}
+ height={630}
+ priority={priority}
+ unoptimized={isGeneratedImage(image)}
+ sizes={sizes}
+ className="aspect-[1200/630] w-full rounded-md border border-neutral-200 object-cover dark:border-neutral-800"
+ />
+ );
+}
- const [latest, ...rest] = sortedPosts;
+export default function BlogPage() {
+ const posts = sortedPosts();
+ const [latest, ...rest] = posts;
return (
<div className="overflow-x-clip">
@@ -55,7 +65,7 @@ export default function BlogPage() {
<div className="relative mx-auto max-w-[1200px] border-x border-neutral-200 dark:border-neutral-800">
<GridCrosses />
- {sortedPosts.length === 0 ? (
+ {posts.length === 0 ? (
<p className="px-5 py-16 text-neutral-600 dark:text-neutral-400 sm:px-8 lg:px-10">
No blog posts yet. Check back soon!
</p>
@@ -72,7 +82,7 @@ export default function BlogPage() {
className="pointer-events-none absolute inset-0 bg-graph-accent [mask-image:linear-gradient(to_bottom,black,transparent_92%),linear-gradient(to_left,transparent,black_40px)] [mask-composite:intersect]"
/>
<article className="relative grid gap-6 lg:grid-cols-12 lg:gap-8">
- <div className="flex flex-col justify-between gap-4 text-sm text-neutral-500 dark:text-neutral-400 lg:col-span-3">
+ <div className="flex flex-col justify-between gap-4 text-sm text-neutral-500 dark:text-neutral-400 lg:col-span-2">
<p className="flex items-center gap-2.5 font-semibold tracking-tight text-emerald-700 dark:text-emerald-400">
<span aria-hidden="true" className="size-2 rounded-[1px] bg-emerald-600 dark:bg-emerald-400" />
Latest post
@@ -83,10 +93,10 @@ export default function BlogPage() {
{formatDate(new Date(latest.data.date))}
</time>
)}
- {latest.data.author && <span>{latest.data.author}</span>}
+ <span>{readingTimeMinutes(latest)} min read</span>
</div>
</div>
- <div className="lg:col-span-9">
+ <div className="lg:col-span-6">
<h2 className="max-w-3xl text-3xl font-semibold leading-[1.08] tracking-[-0.03em] text-neutral-950 text-balance dark:text-neutral-50 md:text-4xl">
{latest.data.title}
</h2>
@@ -103,6 +113,9 @@ export default function BlogPage() {
/>
</span>
</div>
+ <div className="lg:col-span-4">
+ <PostThumbnail post={latest} priority sizes="(max-width: 1024px) 100vw, 380px" />
+ </div>
</article>
</Link>
</li>
@@ -120,18 +133,18 @@ export default function BlogPage() {
href={`/blog/${post.slugs.join("/")}`}
className="group block px-5 py-8 transition-colors duration-200 hover:bg-neutral-50 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-emerald-500 dark:hover:bg-neutral-900/40 sm:px-8 lg:px-10"
>
- <article className="grid gap-2 lg:grid-cols-12 lg:gap-8">
- <div className="text-sm text-neutral-500 dark:text-neutral-400 lg:col-span-3">
+ <article className="grid gap-4 lg:grid-cols-12 lg:gap-8">
+ <div className="text-sm text-neutral-500 dark:text-neutral-400 lg:col-span-2">
<div className="flex flex-wrap items-baseline gap-x-3 gap-y-1 lg:flex-col lg:gap-1.5">
{date && (
<time dateTime={date.toISOString()} className="tabular-nums">
{formatDate(date)}
</time>
)}
- {post.data.author && <span>{post.data.author}</span>}
+ <span>{readingTimeMinutes(post)} min read</span>
</div>
</div>
- <div className="lg:col-span-8">
+ <div className="lg:col-span-7">
<h2 className="text-lg font-semibold tracking-tight text-neutral-950 text-balance dark:text-neutral-50">
{post.data.title}
</h2>
@@ -140,12 +153,16 @@ export default function BlogPage() {
{post.data.description}
</p>
)}
+ <span className="mt-4 inline-flex items-center gap-1.5 text-sm font-medium text-emerald-700 dark:text-emerald-400">
+ Read the post
+ <ArrowRight
+ className="size-3.5 transition-transform duration-200 group-hover:translate-x-0.5 motion-reduce:transition-none"
+ aria-hidden="true"
+ />
+ </span>
</div>
- <div className="hidden items-start justify-end lg:col-span-1 lg:flex">
- <ArrowRight
- className="mt-1.5 size-4 text-neutral-400 transition-transform duration-200 group-hover:translate-x-0.5 motion-reduce:transition-none dark:text-neutral-600"
- aria-hidden="true"
- />
+ <div className="lg:col-span-3">
+ <PostThumbnail post={post} sizes="(max-width: 1024px) 100vw, 280px" />
</div>
</article>
</Link>
diff --git a/docs/src/app/sitemap.ts b/docs/src/app/sitemap.ts
index bca8e03f3..158c9f19e 100644
--- a/docs/src/app/sitemap.ts
+++ b/docs/src/app/sitemap.ts
@@ -37,7 +37,7 @@ export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
// Get all blog posts
const blogPosts = blogSource.getPages().map(post => ({
url: `${baseUrl}/blog/${post.slugs.join("/")}`,
- lastModified: post.data.date || new Date(),
+ lastModified: post.data.updated || post.data.date || new Date(),
changeFrequency: "monthly" as const,
priority: 0.7,
}));
diff --git a/docs/src/lib/blog.ts b/docs/src/lib/blog.ts
new file mode 100644
index 000000000..206cc4549
--- /dev/null
+++ b/docs/src/lib/blog.ts
@@ -0,0 +1,60 @@
+import { blogSource } from "@/lib/blog-source";
+import { createOGImageUrl } from "@/lib/metadata";
+
+export type BlogPost = ReturnType<typeof blogSource.getPages>[number];
+
+const WORDS_PER_MINUTE = 220;
+
+/** Reading time in whole minutes, derived from the indexed body text. */
+export function readingTimeMinutes(post: BlogPost): number {
+ const { structuredData } = post.data;
+ const text = [
+ ...structuredData.headings.map(h => h.content),
+ ...structuredData.contents.map(c => c.content),
+ ].join(" ");
+ const words = text.split(/\s+/).filter(Boolean).length;
+ return Math.max(1, Math.round(words / WORDS_PER_MINUTE));
+}
+
+export function wordCount(post: BlogPost): number {
+ const { structuredData } = post.data;
+ return structuredData.contents.map(c => c.content).join(" ").split(/\s+/).filter(Boolean).length;
+}
+
+/**
+ * Cover image for a post. Falls back to the generated OG card so every post
+ * has a thumbnail on the index and in schema even before a real cover exists.
+ */
+export function postImageUrl(post: BlogPost): string {
+ return post.data.image || createOGImageUrl(post.data.title, post.data.description, "Blog").url;
+}
+
+export function isGeneratedImage(url: string): boolean {
+ return url.startsWith("/og/");
+}
+
+export function absoluteUrl(path: string): string {
+ return path.startsWith("http") ? path : `https://rybbit.com${path}`;
+}
+
+/** Newest first. */
+export function sortedPosts(): BlogPost[] {
+ return [...blogSource.getPages()].sort(
+ (a, b) => new Date(b.data.date).getTime() - new Date(a.data.date).getTime(),
+ );
+}
+
+/** Posts sharing the most tags with `current`, newest first as a tie-break. */
+export function relatedPosts(current: BlogPost, limit = 3): BlogPost[] {
+ const tags = new Set(current.data.tags ?? []);
+ return sortedPosts()
+ .filter(post => post.url !== current.url)
+ .map((post, index) => ({
+ post,
+ shared: (post.data.tags ?? []).filter(tag => tags.has(tag)).length,
+ index,
+ }))
+ .sort((a, b) => b.shared - a.shared || a.index - b.index)
+ .slice(0, limit)
+ .map(entry => entry.post);
+}