Skip to content

SEO: entity signals, breadcrumb/collection structured data, 404 + llms.txt - #224

Merged
carsonSgit merged 1 commit into
mainfrom
seo/structured-data-and-index-hygiene
Nov 7, 2026
Merged

carsonSgit merged 1 commit into
mainfrom
seo/structured-data-and-index-hygiene

Conversation

@carsonSgit

Copy link
Copy Markdown
Owner

Incremental SEO pass on top of the existing solid baseline. Nothing here rewrites the site; each item fixes a specific signal that was inconsistent, duplicated or missing.

Structured data

  • One Person node per page. Case-study Article.author / publisher were restating a second Person inline, which splits entity signals across competing nodes. They now reference #person by @id.
  • Person normalised: full name Carson Spriggs-Audet, alternateName (Carson Spriggs, carsonspriggs), givenName / familyName, jobTitle corrected to "AI Automation Software Developer", worksFor URL lowercased to match the real host, knowsAbout trimmed from 17 generic terms to 6 actually-held ones.
  • BreadcrumbList emitted from the same trail array that SiteNav renders, so visible crumbs and markup cannot drift.
  • CollectionPage + nested ItemList (with position and numberOfItems) on /case-studies.
  • Article gains inLanguage, isPartOf → #website, articleSection, about as Thing nodes.

Crawl and index hygiene

  • Robots directives centralised in lib/seo as ROBOTS and consumed once. googleBot now requests max-image-preview: large, max-snippet: -1, max-video-preview: -1 — Discover eligibility and untruncated snippets.
  • Real app/not-found.tsx: the site previously fell through to the host's default 404 page. Now noindex, follow with recovery links.
  • Titles unified on the canonical name — /case-studies was emitting "Carson Spriggs" while everything else said "Carson Spriggs-Audet", a split brand signal for name queries.
  • Homepage title carries role and city: Carson Spriggs-Audet | AI Automation Developer, Montreal.

Files

  • app/layout.tsx — Person/WebSite graph, ROBOTS
  • app/lib/seo.ts — ROBOTS, breadcrumbSchema, collectionSchema, default title
  • app/components/SiteNav.tsx — breadcrumb markup + JSON-LD
  • app/case-studies/page.tsx, app/case-studies/[slug]/page.tsx
  • app/components/Directory.tsx — list semantics, empty-alt logos, external-link affordances (a11y, and crawlable anchor text)
  • app/not-found.tsx — new
  • public/llms.txt — new

Verified

  • npx tsc -p tsconfig.json --noEmit clean
  • npm run lint (biome ci .) clean, 44 files
  • npm run build ok; the static export was parsed: 0 invalid JSON-LD blocks across all 10 pages, Article + BreadcrumbList + Thing on every case study, CollectionPage + ItemList on the index, noindex, follow on the 404.
  • out/llms.txt present in the export.

Not in this PR

public/logos/*.png were re-encoded locally (322KB → 19KB, 878KB → 13KB) but left uncommitted so this diff stays metadata-only.

@vercel

vercel Bot commented Nov 7, 2026 •

Copy link
Copy Markdown
Contributor

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

Project Deployment Actions Updated
carsonspriggs Ready Ready Preview Nov 7, 2026 8:38pm UTC

…ms.txt

- centralise robots directives in lib/seo and request large image previews
- one Person node per page, referenced by @id from case-study Articles
- BreadcrumbList JSON-LD derived from the visible SiteNav trail
- CollectionPage + ItemList on /case-studies
- unify name in page titles (Spriggs-Audet, not Spriggs)
- real 404 page with noindex, follow
- public/llms.txt for answer engines
@carsonSgit

Copy link
Copy Markdown
Owner Author

Rebased onto main (which now carries #225's per-study share cards). Two conflicts, both from #225 landing first:

  • app/lib/seo.ts — kept both caseStudyCard and ROBOTS
  • app/case-studies/[slug]/page.tsx — kept Give each case study its own social share card #225's caseStudyCard fallback inside the Article schema, alongside this PR's inLanguage / isPartOf / articleSection

Verified after rebase: build 0, biome ci 0, tsc --noEmit 0, all six case studies still emit their own og:image (/og/<slug>.jpg), BreadcrumbList on study pages, CollectionPage on the index, out/404.html and out/llms.txt present.

@carsonSgit
carsonSgit merged commit b4e852a into main Nov 7, 2026
4 checks passed

This branch was successfully deployed

1 active deployment
Preview — 90a45b06 Deployed Nov 7, 2026 by vercel[bot]
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