feat(seo): add localized metadata and hreflang for es/pt routes (#164) by cybermax4200 · Pull Request #169 · wraith-protocol/www

cybermax4200 · 2026-09-25T15:25:15Z

Closes #164

Summary

Wave 9 localized SEO metadata for Spanish and Portuguese routes.

New file: `src/utils/seo.ts`

usePageSeo(page) hook — returns locale-aware title, description,
canonical, and alternates for the active i18n language
canonicalUrl(page) — always returns the English base URL (canonical
is language-neutral, matching the site's localStorage locale
strategy)
hreflangAlternates(page) — emits en, es, pt-BR, and
x-default entries all pointing at the canonical URL

i18n files

Added pageSeo namespace to en.json, es.json, pt.json with
localized title + description for: home, stellar, grants, blog,
caseStudies.

Pages updated

Page	Change
`App.tsx` (Home)	Added `<Helmet>` with `usePageSeo('home')`
`Stellar.tsx`	Replaced hardcoded Helmet with `usePageSeo('stellar')`
`Grants.tsx`	Added `<Helmet>` (previously had none) via `usePageSeo('grants')`
`Blog.tsx`	Replaced hardcoded Helmet in `BlogList` with `usePageSeo('blog')`
`CaseStudies.tsx`	Added `<Helmet>` to `CaseStudiesList` via `usePageSeo('caseStudies')`

Every Helmet now emits: locale-aware <title>, <meta name="description">, <link rel="canonical">, hreflang alternates ×4,
og:title/description/url, twitter:title/description.

`scripts/og.ts`

patchMetadata() injects canonical + hreflang <link> tags into each
static HTML file at build time so crawlers see them before hydration.

Tests

src/__tests__/seo.test.tsx: unit tests for canonicalUrl and
hreflangAlternates, plus integration tests verifying locale-correct
document.title for all 5 pages × 3 locales, and DOM assertions for
hreflang link tags.

Done when checklist

Locale-aware title and description tags on every covered route
hreflang alternates (en, es, pt-BR, x-default) on all 5 pages
Canonical URLs stable and language-mapping verified in tests
Covers home, Stellar, grants, blog, and case studies

…th-protocol#164) - Add pageSeo keys to en/es/pt translation files for home, stellar, grants, blog, and case-studies (title + description per locale) - Add src/utils/seo.ts with usePageSeo hook, canonicalUrl helper, and hreflangAlternates generator (en, es, pt-BR, x-default) - Wire usePageSeo into App (Home), Stellar, Grants, Blog, CaseStudies pages — Helmet now emits locale-aware title, description, canonical link, og:title/description, twitter:title/description, and hreflang alternate links on every covered route - Update scripts/og.ts patchMetadata to inject canonical + hreflang link tags into static HTML files at build time - Add src/__tests__/seo.test.tsx covering canonicalUrl, hreflang alternates, and page-level title/description for all five pages across en, es, and pt locales

vercel · 2026-09-25T15:25:20Z

@cybermax4200 is attempting to deploy a commit to the truthixify's projects Team on Vercel.

A member of the Team first needs to authorize it.

drips-wave · 2026-09-25T15:25:20Z

@cybermax4200 Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits

- Rename hreflang -> hrefLang on HreflangAlternate interface and all usages (React JSX prop is hrefLang, not hreflang) - Remove duplicate usePageSeo import in Blog.tsx

truthixify · 2026-09-25T19:27:55Z

All en, es, pt-BR, and x-default hreflang entries point to the same URL. Search engines need distinct crawlable locale URLs. Please map each language to its real localized route and test those URLs.

truthixify · 2026-09-25T19:28:22Z

All en, es, pt-BR, and x-default hreflang entries point to the same URL. Search engines need distinct crawlable locale URLs. Please map each language to its real localized route and test those URLs.

All four hreflang alternates (en, es, pt-BR, x-default) previously pointed to the same canonical URL, making them useless for search engines. Changes: - src/utils/seo.ts: add LOCALE_URL_PREFIX map and localizedUrl() so es -> /es/*, pt-BR -> /pt/*, en/x-default -> canonical - src/App.tsx: add LocaleScope component + /es/* and /pt/* route variants for home, stellar, grants, blog, case-studies - src/pages/Stellar.tsx: add missing usePageSeo import - scripts/og.ts: fix undeclared canonicalUrl/siteUrl variables in patchMetadata; derive en/es/pt URLs from config.routePath - scripts/gen-sitemap.mjs: include the 10 locale-prefixed routes in sitemap.xml - src/__tests__/seo.test.tsx: update assertions to expect distinct per-locale URLs; add 4 new passing utility tests

cybermax4200 · 2026-09-30T03:21:22Z

All en, es, pt-BR, and x-default hreflang entries point to the same URL. Search engines need distinct crawlable locale URLs. Please map each language to its real localized route and test those URLs.

Done. Please review

truthixify · 2026-09-30T10:50:11Z

The hreflang URLs are distinct now, but navigation leaves them immediately. Header, blog, and case-study links still point to unprefixed routes, and English routes do not reset the locale. Keep locale prefixes during navigation or synchronize the URL and language centrally, then add route-navigation tests.

…ish routes - Add useLocalePath hook that prefixes internal paths with /es or /pt based on the active i18n locale, leaving English paths unprefixed - Add LocaleSync component (mounted in BrowserRouter) that resets the locale to English whenever the URL has no /es or /pt prefix, so navigating back to an English route always syncs the language state - Update Header: convert all bare <a href> internal links to <Link to> and apply lp() to /press, /use-cases, /grants, /stellar, /roadmap, /blog in both desktop nav and mobile menu - Update CaseStudiesStrip: apply lp() to the view-all and card links - Update Footer: apply lp() to all column links and newsletter widget - Add src/__tests__/routing.test.tsx (16 tests) covering: useLocalePath prefix logic, Header link prefixes per locale, LocaleSync reset on unprefixed routes, no-reset on prefixed routes

cybermax4200 · 2026-10-01T15:40:37Z

The hreflang URLs are distinct now, but navigation leaves them immediately. Header, blog, and case-study links still point to unprefixed routes, and English routes do not reset the locale. Keep locale prefixes during navigation or synchronize the URL and language centrally, then add route-navigation tests.

Done, Please review.

truthixify · 2026-10-02T12:01:53Z

Header links are fixed, but Blog and CaseStudies still use unprefixed links, so localized navigation resets to English. Footer now prefixes routes that do not exist, such as /es/privacy and /pt/about, which leads to 404s. Prefix only supported localized routes, update Blog and CaseStudies links, and cover both cases in routing tests.

- Add hasLocalizedRoute() and useLocalizedPath() hook - Update Footer to only prefix routes with localized versions - Add CaseStudies link to Footer with i18n keys - Add comprehensive routing tests for prefixed/non-prefixed cases Fixes 404s for /es/privacy, /pt/about by only prefixing routes with /es/* and /pt/* equivalents (/, /stellar, /grants, /blog, /case-studies)

cybermax4200 · 2026-10-02T13:12:19Z

Header links are fixed, but Blog and CaseStudies still use unprefixed links, so localized navigation resets to English. Footer now prefixes routes that do not exist, such as /es/privacy and /pt/about, which leads to 404s. Prefix only supported localized routes, update Blog and CaseStudies links, and cover both cases in routing tests.

Please Review

truthixify · 2026-10-02T20:09:54Z

The footer fix is good, but Blog and Case Studies still use unprefixed internal links. Please route their list, detail, back, author, and tag links through the locale helper, and add coverage for author and tag paths.

- Update hasLocalizedRoute for blog/author, blog/tag, blog/:slug, case-studies/:slug - Use useLocalizedPath in Blog.tsx and CaseStudies.tsx - Add tests for author/tag paths

cybermax4200 · 2026-10-03T07:36:36Z

The footer fix is good, but Blog and Case Studies still use unprefixed internal links. Please route their list, detail, back, author, and tag links through the locale helper, and add coverage for author and tag paths.

Done, Please review

truthixify · 2026-10-03T12:56:28Z

The content links are fixed, but localized author and tag URLs still have no matching routes in App.tsx, so paths like /es/blog/author/name will 404. Also, usePageSeo still gives every localized page the English canonical URL. Add the missing routes and make canonicals locale-aware, with route-level tests.

- Add /es/blog/author, /es/blog/tag, /pt/blog/author, /pt/blog/tag routes in App.tsx - Fix usePageSeo to return locale-specific canonical URL (not always English) - Add pageSeo translations for home, stellar, grants, blog, caseStudies (en/es/pt) - Add route-level tests for localized blog author/tag and case studies detail pages - Add localizedDynamicUrl helper for dynamic page URLs

cybermax4200 · 2026-10-03T13:49:06Z

The content links are fixed, but localized author and tag URLs still have no matching routes in App.tsx, so paths like /es/blog/author/name will 404. Also, usePageSeo still gives every localized page the English canonical URL. Add the missing routes and make canonicals locale-aware, with route-level tests.

Please Review

truthixify · 2026-10-03T21:15:43Z

The missing routes and list-page canonicals are fixed. Dynamic localized routes still have no canonical or hreflang tags: blog posts, authors, tags, and case-study details use separate metadata, while localizedDynamicUrl is unused. Add localized SEO there or keep those routes unprefixed.

…, tags, case studies) - Add localizedDynamicUrl and hreflangAlternatesDynamic helpers - Update BlogPostDetail, BlogAuthor, TagArchive with locale-aware canonical/hreflang - Update CaseStudyDetail with locale-aware canonical/hreflang - Update SEO tests to use locale-prefixed routes - All 52 routing + blog tests pass, build succeeds

cybermax4200 · 2026-10-04T01:27:11Z

The missing routes and list-page canonicals are fixed. Dynamic localized routes still have no canonical or hreflang tags: blog posts, authors, tags, and case-study details use separate metadata, while localizedDynamicUrl is unused. Add localized SEO there or keep those routes unprefixed.

Done

truthixify

Localized routes now keep their locale and emit matching canonical and hreflang metadata. Required CI passes. Looks good.

truthixify · 2026-10-04T15:09:03Z

Merged. Localized routes now have consistent navigation, canonicals, and hreflang metadata. Thanks @cybermax4200.

cybermax4200 · 2026-10-04T19:53:53Z

Merged. Localized routes now have consistent navigation, canonicals, and hreflang metadata. Thanks @cybermax4200.

@truthixify Thank you so much for the opportunity to contribution in your project

cybermax4200 added 2 commits September 25, 2026 16:26

style: fix prettier formatting in scripts/og.ts

a3ae4f0

fix(seo): hrefLang casing and duplicate import in Blog.tsx

37a22ca

- Rename hreflang -> hrefLang on HreflangAlternate interface and all usages (React JSX prop is hrefLang, not hreflang) - Remove duplicate usePageSeo import in Blog.tsx

cybermax4200 added 2 commits September 30, 2026 03:57

Merge branch 'develop' into feat/wave-9-localized-seo-metadata

aeec9a7

cybermax4200 added 5 commits October 1, 2026 01:51

Merge branch 'develop' into feat/wave-9-localized-seo-metadata

d4c8c02

fix: add missing usePageSeo import to CaseStudies and Grants

77cff47

chore: reformat with pinned prettier 3.8.2, pin exact version

d482a3b

chore: sync lockfile specifier with pinned prettier 3.8.2

8ceda38

cybermax4200 added 3 commits October 3, 2026 08:08

Merge branch 'develop' into feat/wave-9-localized-seo-metadata

bb5a39f

feat(i18n): route Blog/CaseStudies links through locale helper

a5d1875

- Update hasLocalizedRoute for blog/author, blog/tag, blog/:slug, case-studies/:slug - Use useLocalizedPath in Blog.tsx and CaseStudies.tsx - Add tests for author/tag paths

chore: update generated files (sitemap, feeds, blog-manifest)

08309bf

truthixify approved these changes Oct 4, 2026

View reviewed changes

truthixify merged commit 77e74e9 into wraith-protocol:develop Oct 4, 2026
4 of 5 checks passed

cybermax4200 deleted the feat/wave-9-localized-seo-metadata branch October 4, 2026 19:53

Conversation

cybermax4200 commented Sep 25, 2026

Summary

New file: src/utils/seo.ts

i18n files

Pages updated

scripts/og.ts

Tests

Done when checklist

Uh oh!

vercel Bot commented Sep 25, 2026

Uh oh!

drips-wave Bot commented Sep 25, 2026

Uh oh!

truthixify commented Sep 25, 2026

Uh oh!

truthixify commented Sep 25, 2026

Uh oh!

cybermax4200 commented Sep 30, 2026

Uh oh!

truthixify commented Sep 30, 2026

Uh oh!

cybermax4200 commented Oct 1, 2026

Uh oh!

truthixify commented Oct 2, 2026

Uh oh!

cybermax4200 commented Oct 2, 2026

Uh oh!

truthixify commented Oct 2, 2026

Uh oh!

cybermax4200 commented Oct 3, 2026

Uh oh!

truthixify commented Oct 3, 2026

Uh oh!

cybermax4200 commented Oct 3, 2026

Uh oh!

truthixify commented Oct 3, 2026

Uh oh!

cybermax4200 commented Oct 4, 2026

Uh oh!

truthixify left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

truthixify commented Oct 4, 2026

Uh oh!

cybermax4200 commented Oct 4, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

New file: `src/utils/seo.ts`

`scripts/og.ts`