🐸 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.mjsindex 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.tsindex 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.tsxindex 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 SEOconst 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: strisrc={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"+ />+ )}+<divclassName="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/30prose-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"><MDXContentcomponents={{...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.tsxindex 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.tsindex 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 postsconst 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.tsnew file mode 100644index 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);+}