fix: resolve SEO audit issues (hreflang redirects, orphan page, broken links)

[shahbaz17]

Description

Fixes the issues flagged in the July 2 SEO audit (hreflang-to-redirect, orphan page, and links-to-broken-page reports), plus two small tooling fixes needed to get the changes through the local pre-commit hook.

SEO fixes

• Hreflang → redirect (38 flagged pages): Docusaurus (trailingSlash: true) emits hreflang alternates with a trailing slash, but Vercel serves paths whose final segment contains a dot (e.g. 1.5.0) without one, causing a 308. The llms-html-injector post-build plugin already strips the slash from canonical/og:url on these routes; this extends the same fix to the hreflang="en" and hreflang="x-default" alternates so the Smart Accounts Kit changelog/version pages stop pointing hreflang at redirects.
• Orphan page: /smart-accounts-kit/1.5.0/guides/x402/buyer/advanced-permissions/ was intentionally hidden from nav but still ships in the frozen 1.5.0 snapshot with no incoming links. Added a permanent redirect to the current equivalent in vercel.json.
• Broken external links:
  • Wagmi Vue: wagmi.sh/vue → wagmi.sh/vue/getting-started.
  • Circle: .../stablecoins/docs/usdc-on-test-networks → .../stablecoins/usdc-contract-addresses.
  • Pimlico: dashboard.pimlico.io/apikeys → docs.pimlico.io/guides/create-api-key (2 tutorials).
  • Removed the dead Web3Auth React Playground example (web3auth-playground.vercel.app, permanently 404).
• OpenUPM (44 Unity pages): The package.openupm.com registry URL is correct but returns 404 at its HTML root (expected for a package registry), so it was flagged as broken. Added a plain prop to CopyableNoFollow that renders the value as non-link copyable text (keeping the copy button), and applied it in the two shared Unity partials.

Tooling

• Added ambient *.module.css / *.module.scss declarations to src/globals.d.ts so the isolated tsc-files pre-commit hook can type-check CSS-module components (this was a pre-existing gap that surfaced when editing CopyableNoFollow).
• Removed the Vale check from the lint-staged pre-commit hook (it's CI-only) and documented why it must not be re-added — it produces false positives on valid technical content (e.g. wagmi-tab, product names, intentional ellipses) and lints the whole staged file rather than the diff. PR CI still runs Vale.

Notes / non-changes

• The npmjs.com 403s in the audit are bot-protection responses, not real breakage.
• The remaining Vale warnings (wagmi-tab, "composables", ellipses in Unity steps) are pre-existing false positives on valid technical content.

Test plan

• npm run typecheck passes.
• npm run format:check passes in CI.
• After deploy, confirm hreflang tags on a dotted route (e.g. /smart-accounts-kit/1.5.0/changelog/1.5.0/) no longer end in / and return 200.
• Confirm the orphaned 1.5.0 advanced-permissions URL redirects (308) to the current page.
• Spot-check the updated Wagmi/Circle/Pimlico links resolve to 200.

---

Note

Low Risk
Changes are limited to docs content, post-build HTML normalization, redirects, and lint/CI workflow behavior with no impact on runtime auth or user data.

Overview
Addresses July SEO audit findings: hreflang tags pointing at 308 redirects, an orphan versioned page, and broken or misleading external links, plus contributor tooling so commits are not blocked by Vale false positives.

Hreflang / canonical alignment: The llms-html-injector post-build step already strips trailing slashes from canonical and og:url on dotted final segments (where Vercel serves without a slash). It now applies the same normalization to rel="alternate" tags with hreflang, so Smart Accounts Kit version/changelog URLs stop advertising redirecting hreflang targets.

Routing & content: Adds a permanent redirect in vercel.json from the hidden 1.5.0 advanced-permissions snapshot to the current guide. Updates tutorial/docs links (Pimlico API key, Circle USDC addresses, Wagmi Vue getting started). Removes the dead React Playground example from example-maps. For OpenUPM registry URLs that 404 at the HTML root, CopyableNoFollow gains a plain mode (copyable text, no anchor) in the shared Unity partials.

Tooling: Vale is removed from Husky lint-staged; CI Spelling still runs Vale but the step uses continue-on-error: true so required checks pass while warnings stay in logs. Contributor docs warn against re-adding Vale to pre-commit. src/globals.d.ts adds *.module.css / *.module.scss declarations so tsc-files can type-check components like CopyableNoFollow in the isolated pre-commit hook.

^{Reviewed by Cursor Bugbot for commit db65037. Bugbot is set up for automated code reviews on this repo. Configure here.}

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
metamask-docs	Ready	Preview, Comment	Jul 2, 2026 7:42am