Skip to content

seo: add /about page with neutral brand voice#99

Merged
smaramwbc merged 1 commit into
mainfrom
seo-about-page
May 25, 2026
Merged

seo: add /about page with neutral brand voice#99
smaramwbc merged 1 commit into
mainfrom
seo-about-page

Conversation

@smaramwbc
Copy link
Copy Markdown
Owner

Summary

External SEO audit (Section 3 #7) flagged the absence of an About page as a missing EEAT signal — search quality raters and AI answer engines look for one to confirm a project is real and verifiable. Ship one, with the project's existing constraints intact.

Constraints honored

  • Neutral brand voice — no founder names anywhere. The Statewave project is the identity for public surfaces; individual contributors are visible on GitHub. Sign-off is "the Statewave team".
  • No managed-cloud / VC framing — the positioning that already runs across the site (open source, self-hosted, Apache-2.0, framework-neutral, provenance-first) carries through verbatim.
  • No drift on proof figures — hoisted the 680 / 55 / 8/8 / 2/8 stats out of `HomePage.tsx` into a shared `src/lib/proof-stats.ts` so the homepage hero, the deeper ProofSection, and now /about all cite the same source. Matches the "proof figures mirrored across many surfaces — recompute together" rule.

Page layout

Mirrors the simple-page idiom from `CookiesPage` / `ImpressumPage`:

  1. Eyebrow + h1 + mission paragraph — what Statewave is and why
  2. What we're committed to — four principles (open source / self-hosted / provenance first / framework-neutral)
  3. Proven, not promised — the same `PROOF_STATS` the homepage surfaces, plus a link to `statewave-bench` so anyone can reproduce
  4. What we ship — the nine public `statewave-*` repos with one-line descriptions
  5. Get in touch — GitHub issues for product, `licensing@` for commercial, `press@` for press, `security@` for disclosures

Wiring

`PUBLIC_ROUTES` is the single source of truth for sitemap, nav, and llms.txt — adding `/about` flows through all of them:

  • `src/lib/seo-meta.ts` — add `'/about'` to `RouteKey` union and `PUBLIC_ROUTES`; add `PAGE_META` entry (priority 0.6, monthly changefreq)
  • `src/App.tsx` — lazy route for `AboutPage`
  • `src/components/Navbar.tsx` — top-nav link (last position)
  • `src/components/Footer.tsx` — link in the Community column
  • `public/sitemap.xml` — new `` entry
  • `public/llms.txt` — new "About" line in the Primary links list

Test plan

  • `npm run build` — 1.5% HTML size delta on the homepage (+152 bytes from the extra nav link; well under the SSR floor)
  • `npx vitest run` — 282 + 1 skipped. The sitemap-parity test in `tests/seo-static.test.ts` (which iterates `PUBLIC_ROUTES`) and the JSON-LD URL tests pick up /about automatically
  • `npm run lint`, `npm run typecheck` — green
  • CI green
  • After deploy: `https://www.statewave.ai/about\` renders the page; `https://www.statewave.ai/sitemap.xml\` includes the new URL; nav + footer link to it

External SEO audit (Section 3 #7) flagged the absence of an About page
as a missing EEAT signal — search quality raters and AI answer engines
look for one to confirm a project is real and verifiable. Ship one.

Constraints honored:
  * Neutral brand voice — no founder names anywhere. The Statewave
    project is the identity for public surfaces; individual
    contributors are visible on GitHub. Sign-off is "the Statewave
    team".
  * No managed-cloud / VC framing — the positioning that already
    runs across the site (open source, self-hosted, Apache-2.0,
    framework-neutral, provenance-first) carries through verbatim.
  * No drift on proof figures — hoisted the 680 / 55 / 8/8 / 2/8
    stats out of HomePage.tsx into a shared src/lib/proof-stats.ts
    so the homepage hero, the deeper ProofSection, and now /about
    all cite the same source. Matches the "proof figures mirrored
    across many surfaces — recompute together" rule.

Page layout (mirrors the simple-page idiom from CookiesPage etc.):
  1. Eyebrow + h1 + mission paragraph (what Statewave is and why)
  2. "What we're committed to" — four principles (open source /
     self-hosted / provenance first / framework-neutral)
  3. "Proven, not promised" — the same PROOF_STATS the homepage
     surfaces, plus a link to statewave-bench so anyone can repro
  4. "What we ship" — the nine public statewave-* repos with a
     one-line description of each
  5. "Get in touch" — GitHub issues for product, licensing@ for
     commercial, press@ for press, security@ for disclosures.

Wiring (PUBLIC_ROUTES is the single source of truth for sitemap,
nav, and llms.txt — adding /about flows through all of them):
  * src/lib/seo-meta.ts — add '/about' to RouteKey union and
    PUBLIC_ROUTES; add PAGE_META entry with breadcrumb, title,
    description, priority 0.6, monthly changefreq.
  * src/App.tsx — lazy route for AboutPage.
  * src/components/Navbar.tsx — top-nav link (last position).
  * src/components/Footer.tsx — link in the Community column.
  * public/sitemap.xml — new <url> entry.
  * public/llms.txt — new "About" line in the Primary links list.

Verification:
  * `npm run build` — 1.5% HTML size delta on the homepage
    (+152 bytes from the extra nav link, well under SSR floor).
  * `npx vitest run` — 282 + 1 skipped. The sitemap-parity test in
    tests/seo-static.test.ts (which iterates PUBLIC_ROUTES) and
    the JSON-LD URL tests pick up /about automatically.
  * `npm run lint`, `npm run typecheck` — green.
@vercel
Copy link
Copy Markdown
Contributor

vercel Bot commented May 25, 2026

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

Project Deployment Actions Updated (UTC)
statewave-web Ready Ready Preview, Comment May 25, 2026 1:15pm

Request Review

@smaramwbc smaramwbc merged commit 92e3a3c into main May 25, 2026
6 checks passed
@smaramwbc smaramwbc deleted the seo-about-page branch May 25, 2026 13:17
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