Responsive fix, design system, SEO, brand mark, and creator page

[folathecoder]

Fix the mobile layout, then rebuild the site's visual and SEO foundations on one token layer. 19 commits, each reviewable on its own; the batches are tokens, primitives, shell, pages, copy, cleanup, SEO, content, brand, creator.

Layout and chrome

• Docs content collapsed to 0px below 1024px: the sticky page selector was a w-full child of the docs flex row. The layout now stacks below lg. This bug is live on agentling.dev today.
• The mobile sheet rendered off screen because its parent's backdrop-filter became the containing block for a fixed element. It is portaled to body with a focus trap, scroll lock, and Escape to close.
• The header's overflow-hidden clipped the mobile menu and the version menu.
• The compact theme toggle uses resolvedTheme, so it works under "system".

Design system

• Semantic tokens only (surfaces, borders, three text levels, accent, success/warning/danger), two tuned palettes, two radii, two shadows, a nine-step type scale with an 11px floor. Stock Tailwind palette, radius, shadow and text scales removed.
• IBM Plex Sans replaces Inter, self-hosted and Latin-subset via next/font with font-display: swap. JetBrains Mono for code.
• Search palette, sidebar, table of contents (inline below xl), header, pages, pager, feedback row and 404 restyled. Press and hover states only; nothing animates on the palette or theme switch.
• Dead components, the motion dependency and the phantom /feed.xml link removed. <main> landmark and a one-line footer on every page.

SEO

• pageMetadata is the single source of title, description, canonical, Open Graph and Twitter tags; title template %s | Agentling.
• metaTitle and metaDescription frontmatter on all 20 content pages, length-checked by the validator. Dates from git per file.
• JSON-LD: Organization, WebSite and SoftwareApplication site-wide; TechArticle with a full BreadcrumbList on docs; WebPage elsewhere. Validated on validator.schema.org with 0 errors, 0 warnings.
• Sitemap lists the 22 indexable pages with git lastmod. / and /docs are 308s, /docs/<section> redirects to its first page, /feed.xml, /blog and /roadmap redirect to their replacements. The 404 is noindex.

Brand

• "Steps" mark replaces the emerald terminal chevron. icon.svg follows the colour scheme; favicon.ico, apple-icon.png and the PWA icons are generated from the same geometry by scripts/generate-icons.mjs (sharp, devDependency). Manifest and theme colours come from the tokens.
• Open Graph card redrawn on the paper ground with the mark, no gradient.

Creator page

• /creator: first-person profile of Folarin Akinloye, creator of Agentling, with ProfilePage and Person JSON-LD sharing one Person @id with the software's creator and every doc's author. Indexable and in the sitemap, but deliberately absent from navigation, footer, search and internal links. Documented in the README.

Verification

• Lint, type check, content validation and next build pass. There is no test suite in this repo.
• Playwright sweep of 24 routes at 320, 375, 768, 1024, 1280 and 1920px: no horizontal overflow, no console errors, 11px minimum text.
• Keyboard-only runs through the palette, sidebar, theme control, code copy and mobile sheet. Reduced motion exercised.
• Lighthouse mobile, same page, same local server, before vs after: performance 96 vs 96 to 99, accessibility 96 vs 100, best practices 100 vs 100, SEO 100 vs 100, CLS 0.

After merge

• Add a www DNS record and 301 to the apex at the host; www.agentling.dev does not resolve.
• Submit the sitemap in Search Console and run the Rich Results Test on the live URLs.
• Run node scripts/generate-icons.mjs whenever the mark changes.

🤖 Generated with Claude Code