Skip to content

feat(docsite): SEO audit + per-page meta + landing CTA fix#9

Merged
rqbazan merged 3 commits into
mainfrom
feat/docsite-seo-audit
May 16, 2026
Merged

feat(docsite): SEO audit + per-page meta + landing CTA fix#9
rqbazan merged 3 commits into
mainfrom
feat/docsite-seo-audit

Conversation

@rqbazan

@rqbazan rqbazan commented May 16, 2026

Copy link
Copy Markdown
Member

Summary

  • Per-page meta on /docs/* — surface MDX frontmatter title/description through TanStack Start's head: callback. Lifts SEO from 90 → 100 on all 22 doc pages.
  • Landing CTA fix — "Read the docs" now points to /docs (the index) via LANDING_META.docsHref.
  • Unlighthouse audit in CI (docsite.yml) with per-category budgets (SEO 100, BP 100, A11y 90, Perf 50) — any drop in meta-description, document-title, is-crawlable etc. fails the PR.
  • No dev-install bloatunlighthouse + start-server-and-test are pulled on-demand via pnpm dlx inside scripts, not added to package.json. Workflow caches ~/.cache/pnpm/dlx. See docsite/CLAUDE.md for the version-pin/cache-key drift note.

Test plan

  • pnpm --filter docsite check:seo-ci passes locally — 22/22 routes hit budgets
  • tsc --noEmit + biome clean (pre-commit hooks green)
  • Docsite workflow runs on this PR and passes

rqbazan and others added 3 commits May 16, 2026 11:03
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
…e CI

unlighthouse-ci leaks Chrome handles and never exits after a successful
scan, hanging the GHA step for minutes. @lhci/cli handles the full
preview-server lifecycle natively with cleanup. Same `pnpm dlx` pattern
keeps it out of the dev install.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@rqbazan
rqbazan force-pushed the feat/docsite-seo-audit branch from f0e8181 to b571742 Compare May 16, 2026 20:19
@rqbazan
rqbazan merged commit c37f7ce into main May 16, 2026
12 checks passed
@rqbazan
rqbazan deleted the feat/docsite-seo-audit branch May 16, 2026 20:25
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