Services

Seo Optimization Review 2026 06 17

SEO optimization review summary

Date: 2026-06-17

This consolidates the three SEO review slices. It is a priority guide, not a replacement for the source reports.

Source reports#

Priority-ranked recommendations#

P0 — Stabilize production origins and sitemap correctness#

  1. Make www production metadata use an explicit canonical site URL instead of Vercel-only environment signals. The technical audit found SITE_ORIGIN can fall back to localhost/preview values outside Vercel production, affecting metadataBase, canonicals, and OpenGraph URLs.
  2. Replace or update the www sitemap generator so it reads the current App Router route graph and content sources. The current generator is still centered on legacy Pages Router/content paths while robots.txt advertises sitemap_www.xml.
  3. Include the Academy sitemap in the root sitemap index if Academy should be discoverable from the main property sitemap submission.

Evidence: Technical SEO audit.

P1 — Add route-level metadata for high-intent public pages#

Add deterministic metadata/generateMetadata first for conversion and discovery routes that currently inherit generic app metadata, especially www contact, quote, guide, and training routes; Academy course/path discovery routes; and design-system/ui-library app home routes.

Evidence: Public content SEO audit.

P1 — Verify rendered heading/canonical behavior before broad content edits#

Run a narrow rendered crawl of top pages before changing heading structure. The static scan found many page modules without literal <h1> tags, but some headings may be provided by imported components or MDX.

Evidence: Public content SEO audit.

P2 — Add dedicated SEO regression checks#

Add explicit SEO tasks rather than broadening verify:root-runtime:

  • seo:metadata for title, description, canonical, OpenGraph, Twitter card, and route-specific robots assertions.
  • seo:sitemaps for XML parseability, expected app roots, production URLs, and absence of localhost/preview URLs.
  • seo:robots for advertised sitemap URLs and production/preview indexability rules.

Evidence: SEO regression coverage review.

P2 — Improve long-tail content and app-level metadata quality#

Prioritize unique descriptions for Academy course indexes/overviews and public docs before long-tail labs. Tighten UI Library root metadata by making the description more specific, using an evergreen website OpenGraph type at the app root, and adding OG image alt text where layout metadata defines images.

Evidence: Public content SEO audit and thin metadata finding.

P3 — Extend link coverage after core SEO checks are stable#

Existing release-oriented link checks cover www, docs, and academy best. Add stable production link-health specs/tasks for blog, design-system, and ui-library, then include them in the broader production link check.

Evidence: SEO regression coverage review.

Narrow verification commands used by the slices#

bash
1
find apps/www apps/blog apps/docs apps/academy -path '*/app/*' \
2
  \( -name 'robots.ts' -o -name 'sitemap.ts' -o -name 'layout.tsx' -o -name 'page.tsx' \) -print
3
4
rg -n "metadataBase|alternates|canonical|openGraph|twitter|robots|noindex|sitemap|redirect|permanentRedirect|NextResponse.redirect|SITE_URL|NEXT_PUBLIC_SITE|X-Robots-Tag" \
5
  apps/www apps/blog apps/docs apps/academy apps/*/next.config.mjs -S
6
7
mise exec -- node - <<'JS'
8
// Static page scan for route metadata exports and literal h1 usage.
9
JS
10
11
mise tasks | rg 'check:links|test:e2e|e2e|cf:build|cf:publish|verify:root-runtime|test:smoke|build:sitemap|robots|sitemap'
12
13
find apps -maxdepth 3 \( -name 'sitemap.*' -o -name 'robots.*' \) -print