Skip to content

feat(seo): canonical tags, sitemap, robots, per-page OG images#11

Open
ggonzalez94 wants to merge 1 commit intomainfrom
near-puppy
Open

feat(seo): canonical tags, sitemap, robots, per-page OG images#11
ggonzalez94 wants to merge 1 commit intomainfrom
near-puppy

Conversation

@ggonzalez94
Copy link
Copy Markdown
Member

@ggonzalez94 ggonzalez94 commented Apr 13, 2026

Summary

Run an SEO audit using this skill and applied the recommended fixes

Adds the foundational SEO surface the docs site was missing:

- Per-page <link rel="canonical">, og:url, og:site_name, og:locale, and
  twitter:site injected via Vocs's native head({ path }) hook.
- Dynamic per-page OG images via Vocs's hosted API (ogImageUrl, object
  form — the string form short-circuits in useOgImageUrl on v1.4.1).
- baseUrl wired to the existing siteUrl chain so Vocs emits <base> and
  resolves %logo for OG image rendering.
- iconUrl set so <link rel="icon"> ships in <head>.
- sitemap.xml + robots.txt generated by extending the existing post-build
  walker in scripts/substitute-site-url.mjs. Previews emit Disallow: /
  and every page gets noindex so Vercel preview URLs never compete with
  production in search.
- Homepage H1/title rewritten so titleTemplate no longer produces the
  broken "Taiko - Taiko" tag, and 13 short meta descriptions rewritten
  from 40–80 characters to 140–160 with primary keywords.

Renames vocs.config.ts -> vocs.config.tsx because head({ path }) uses
JSX. Updates the lone tsconfig.json + site-url.mjs references.

Verified locally on both prod (VERCEL_ENV=production) and preview builds:
canonical + og:image + robots + sitemap all emit correctly per environment.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
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