Skip to content

SEO fixes and a social card for every page - #103

Merged
b4rb13 merged 1 commit into
mainfrom
site/seo
Nov 20, 2026
Merged

b4rb13 merged 1 commit into
mainfrom
site/seo

Conversation

@b4rb13

@b4rb13 b4rb13 commented Nov 20, 2026

Copy link
Copy Markdown
Owner

Summary

Fixes from a full SEO audit of dotquilt.dev (the /seo plugin's technical, content, schema, sitemap, performance, mobile, AI search, agent-readiness, search-experience and social-image audits), plus a social card for every page.

 apps/site/
+├── src/lib/og.ts                 renders a 1200×630 card (satori → SVG, resvg → PNG), site colours and fonts
+├── src/lib/cards.ts              each page's card: section, title, description, ?v= hash, alt text
+├── src/pages/og/[...slug].png.ts /og/<page>.png for every page; /og.png stays the home card
 ├── src/routeData.ts              per-page og:image (+ secure_url, type, size, alt), twitter:image(+alt),
 │                                 <link rel=alternate type=text/markdown>, JSON-LD @graph, 404 noindex
 ├── src/content/docs/**           search terms in <title> (head field) and descriptions; headings unchanged
+├── src/content/docs/404.mdx      a real "Page not found" page
+├── …/guides/skeleton-or-spinner  new guide: "Skeleton screen vs spinner: when to use each"
 ├── src/components/home/Hero.astro  hero without a title falls back to the page title (404's h1 was empty)
 ├── src/pages/llms.txt.ts         llmstxt.org layout: guidance before the first H2, link lists in sections
 ├── vercel.json                   trailingSlash + cleanUrls redirects, security headers, noindex on .md
 └── astro.config.mjs              fonts from Fontsource (same origin) instead of Google Fonts
Audit finding Fix
Every page shared one screenshot card; alt text described the wrong page A card per page (title, section, the Quilt tile, marks that hand over to a teal line), with per-page alt
"Skeleton loader" never appeared in a title, heading or visible text Titles and descriptions use the search terms; first sentences name Dotquilt; a "What is a skeleton loader?" section
No page for "skeleton screen vs spinner" New guide, citing NN/g's response-time and skeleton-screen articles
Accessibility material didn't say what screen readers hear "What screen readers hear" (aria-hidden, inert, aria-busy, from the runtime's code); TypingDots accessibility
404 had an empty <h1> and a canonical to /404/ Real page, noindex, no canonical
Only one JSON-LD block on the site WebSite + SoftwareApplication + SoftwareSourceCode on /; BreadcrumbList + TechArticle on docs pages. No ratings, reviews, people or contact details
.md copies indexable as duplicates; no link from HTML to them X-Robots-Tag: noindex on .md and llms-full.txt; <link rel="alternate" type="text/markdown">
/docs/theming, /index.html answered 200 trailingSlash and cleanUrls 308 redirects
Only HSTS among security headers nosniff, Referrer-Policy, X-Frame-Options SAMEORIGIN, Permissions-Policy
Google Fonts stylesheet blocked rendering; font swap caused the home CLS Fonts served from the site; privacy page and SPEC updated
Short descriptions (license 19 characters) Rewritten, 100–150 characters

Evidence

  • tests/site/discovery.spec.ts:
    • per-page cards (tags, 1200×630 PNG under 300 KB);
    • titles and headings;
    • JSON-LD on / and docs pages;
    • the 404 page (fails on main: empty <h1>, canonical /404/);
    • the Markdown alternate links;
    • no request to another origin, with Manrope and DM Mono loaded;
    • the llms.txt layout;
    • the sitemap with the new guide.
  • Site tests: 87 passed. Unit tests: 38 passed. bun run lint, bun run check and tsc for the site pass.
  • Preview checks: see the comment below.

Merge Danger

Door: two-way

Blast Radius: site-wide head tags, URLs and fonts

  • trailingSlash/cleanUrls add redirects for slashless and .html addresses; files with extensions aren't redirected.
  • Fonts now come from the site instead of Google: the same families and weights (400–700, DM Mono 400/500).
  • Visible copy changes: the home tagline, first sentences of component pages, new sections, and the new guide.
  • Everything reverts with the PR.

🤖 Generated with Claude Code

From a full SEO audit (technical, content, schema, sitemap, performance,
mobile, AI search, agent readiness, search experience, social images):

- Social cards: every page gets its own 1200x630 PNG, rendered at build
  time in the site's style (satori + resvg), with og:image type, size and
  alt, twitter:image and twitter:image:alt, and ?v= for cache busting.
- Titles and descriptions name what people search for (skeleton loader,
  typing indicator, chart and table skeleton), through Starlight's head
  field so headings and the sidebar keep their short names.
- Copy: a "What is a skeleton loader?" section, first sentences that name
  Dotquilt, "What screen readers hear" in the motion guide, accessibility
  for TypingDots, and a new guide: "Skeleton loader or spinner?".
- JSON-LD: WebSite, SoftwareApplication and SoftwareSourceCode on the home
  page; BreadcrumbList and TechArticle on docs pages.
- 404: a real "Page not found" heading (the hero override dropped the
  title), noindex and no canonical.
- Each page links its Markdown copy; .md and llms-full.txt are noindex;
  llms.txt follows the llmstxt.org layout.
- Vercel: trailing-slash and clean-URL redirects, and security headers.
- Fonts are served from the site (Fontsource) instead of Google Fonts:
  no render-blocking request to another origin.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@vercel

vercel Bot commented Nov 20, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
dotquilt Ready Ready Preview Nov 20, 2026 9:31pm UTC

Request Review

@b4rb13

b4rb13 commented Nov 20, 2026

Copy link
Copy Markdown
Owner Author

Preview checks (02d4933, dotquilt-git-site-seo-…vercel.app):

Request Answer
/ as a browser, and with Accept: text/markdown (GET and HEAD) 200 HTML / 200 text/markdown, Vary: Accept
/docs/theming, /index.html, /docs/theming/index.html 308 redirect (trailing slash, clean URLs)
/docs/installation/, /docs/guides/skeleton-or-spinner/ with text/markdown 200 Markdown
/license/ with text/markdown 200 summary
/__probe-404/ with text/markdown / text/html 404 Markdown "Page not found" / 404 HTML
/index.md, /llms.txt, /llms-full.txt, /setup-prompt.md, /robots.txt, /sitemap-index.xml 200
/og.png, /og/index.png, /og/docs/components/skeleton.png, /og/docs/guides/skeleton-or-spinner.png 200 PNG, 1200×630, about 96–100 KB
Headers on every response X-Content-Type-Options: nosniff, X-Frame-Options: SAMEORIGIN
Fonts on a docs page Manrope 400/500/600 and DM Mono 400 loaded from the site; no request to Google

Previews get Vercel's own X-Robots-Tag: noindex on every response, so the .md-only noindex rule can only be told apart on production: check after merge that / has no X-Robots-Tag and /docs/installation.md has noindex.

@b4rb13
b4rb13 merged commit 726b0ac into main Nov 20, 2026
9 checks passed
@b4rb13
b4rb13 deleted the site/seo branch November 20, 2026 22:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant