blog.hangerthem.com/lib/og-image.tsx
HangerThem 30ef0d611e Bug fixes, SEO, performance and accessibility pass (#1)
## Summary

A cleanup pass across the blog: route and feed bugs fixed, SEO basics added, smaller and lazier images, accessibility fixes, and a real README. No content or design changes beyond small fixes.

## Bug fixes

- **Tag/category pages**: static params now use slugs, so pre-rendered pages match the links (before, `/tags/standard-model` was only rendered on demand and the pre-built pages said "Tag not found"). Unknown slugs now return a real 404, and there's a new not-found page.
- **Recently updated**: sorts by last modification *before* taking the top 5, so older posts that were updated recently now show up.
- **Atom feed**: `rel="self"` now points to `/feed.xml` (was `/feed`); `<updated>` uses the `updated` frontmatter field.
- **No-JS flash**: the `no-js` → `js` class swap runs in an inline `<head>` script before first paint, not after hydration.
- **Markdown links**: only internal paths go through `next/link`; `#anchors`, `mailto:` and links without an `href` no longer break.
- **Invalid HTML**: images in a paragraph together with text (e.g. "**Screenshots:**" followed by images on the Projects page) produced `<p><figure>` and a hydration error. Those paragraphs are now split.
- **Dates**: frontmatter dates are normalized to ISO, so `<time datetime>` values are valid. Formatting is pinned to Europe/Prague so a UTC build server can't shift a date by a day.

## SEO

- `sitemap.xml` and `robots.txt`
- Canonical URLs, Twitter cards and a feed link on every page, built by a shared `pageMetadata()` helper
- Generated Open Graph images: a site card, and for each post its cover image or a branded title card (pre-rendered at build time)
- `BlogPosting` JSON-LD on post pages

## Performance

- Only the post cover and the latest-post image are preloaded (was: every image)
- In-post image quality 100 → 90, plus responsive `sizes`
- Screenshots downscaled to 1800px wide; `linkboard-old.png` converted to WebP (3.1 MB → 60 KB)
- `CodeWrapper` is now a server component; only the copy button ships to the client
- Mermaid CDN script pinned to `11.17.2` for reproducible builds

## Accessibility

- Accessible names for icon-only links (share, social, mobile nav) and `aria-current` on active nav items
- Copy button: uses React state instead of mutating `innerHTML`, handles clipboard errors, announces the result to screen readers, and is no longer inside an `aria-hidden` header
- Code-block line numbers hidden from screen readers
- Image captions: the Markdown `"title"` becomes the caption; captions that only repeat the alt text are hidden from screen readers

## Content & maintenance

- **Frontmatter validation**: a missing or malformed field fails the build and names the file, instead of rendering a broken post
- **`draft: true` support**: drafts only render in development
- About/Projects/Setup pages share one `MarkdownPage` component; tag/category lists share `PostList`
- Markdown rendering is cached, so metadata and page share one render
- New README covering features, env vars, frontmatter schema, Markdown extensions and deployment
- Removed unused ESLint setup and the unrelated `hast` package; `oxlint`, `oxfmt` and `puppeteer` moved to devDependencies (locked versions unchanged)
- Typo fix in the Tessera cover alt text; removed unused `math`/`mermaid` flags from two posts

## Deployment notes

- **`SITE_URL` is now required**: the build fails with a clear error if it's missing.
- **Puppeteer is a devDependency now**: Nixpacks installs dev dependencies for the build by default, but check that Mermaid diagrams render on the first deploy (the Standard Model post has one).

## Testing

- `tsc --noEmit` and `bun run lint` pass
- `bun run build` passes; all 81 pages are generated statically
- Smoke-tested `next start`: posts, tags, categories, feed, sitemap and OG images return 200; unknown tags and routes return 404
- No block elements nested inside `<p>` in any built page

Reviewed-on: #1
2026-10-19 12:41:40 +00:00

81 lines
2.8 KiB
TypeScript

import fs from 'fs'
import path from 'path'
import { ImageResponse } from 'next/og'
import { SITE_NAME, SITE_URL } from '@/app/metadata'
export const ogImageSize = { width: 1200, height: 630 }
const colors = { bg: '#040404', fg: '#e0e0e0', fgDim: '#b0b0b0', accent: '#ef1f1f' }
function toDataUri(filePath: string, mime: string) {
return `data:${mime};base64,${fs.readFileSync(filePath).toString('base64')}`
}
const logo = toDataUri(path.join(process.cwd(), 'public/logo.png'), 'image/png')
type OgCardProps = {
title: string
description?: string
eyebrow?: string
}
/** Renders the branded title card used for pages and posts without a cover image. */
export function renderOgCard({ title, description, eyebrow }: OgCardProps) {
return new ImageResponse(
<div
style={{
width: '100%',
height: '100%',
display: 'flex',
flexDirection: 'column',
justifyContent: 'space-between',
padding: '64px 72px',
background: colors.bg,
color: colors.fg,
borderLeft: `16px solid ${colors.accent}`,
}}
>
<div style={{ display: 'flex', flexDirection: 'column', gap: 20 }}>
{eyebrow && (
<div style={{ fontSize: 28, color: colors.accent, textTransform: 'uppercase' }}>
{eyebrow}
</div>
)}
<div style={{ fontSize: title.length > 50 ? 60 : 76, fontWeight: 700, lineHeight: 1.1 }}>
{title}
</div>
{description && (
<div style={{ fontSize: 30, color: colors.fgDim, lineHeight: 1.4, maxHeight: 130 }}>
{description.length > 140 ? description.slice(0, 137).trimEnd() + '…' : description}
</div>
)}
</div>
<div style={{ display: 'flex', alignItems: 'center', gap: 16, fontSize: 30 }}>
{/* oxlint-disable-next-line nextjs/no-img-element -- Satori renders plain <img> only */}
<img src={logo} width={48} height={48} alt="" />
<span style={{ fontWeight: 700 }}>{SITE_NAME}</span>
<span style={{ color: colors.fgDim }}>{SITE_URL.replace(/^https?:\/\//, '')}</span>
</div>
</div>,
ogImageSize,
)
}
const coverMimeTypes: Record<string, string> = {
'.png': 'image/png',
'.jpg': 'image/jpeg',
'.jpeg': 'image/jpeg',
}
/** Renders a post's cover image at OG size, or null if the format isn't supported by Satori. */
export function renderOgCover(coverImage: string) {
const mime = coverMimeTypes[path.extname(coverImage).toLowerCase()]
if (!mime) return null
const src = toDataUri(path.join(process.cwd(), 'public/posts', coverImage), mime)
return new ImageResponse(
// oxlint-disable-next-line nextjs/no-img-element -- Satori renders plain <img> only
<img src={src} width={ogImageSize.width} height={ogImageSize.height} alt="" />,
ogImageSize,
)
}