Description
Wire per-page <head> injection into the landing worker: canonical URL, Open Graph tags, Twitter card, and expanded JSON-LD (BlogPosting, TechArticle, SoftwareApplication, FAQPage). Without this, every blog post published is SEO-invisible and LLMs have no structured data to parse.
Context
Part of GEO/SEO strategy v1 (28-day scope).
- Design doc:
plans/geo-seo-strategy.md
- Full task spec:
plans/geo-seo-strategy/phase-01-foundation-infra.md → Task 2
- Technical reviewer flag: current landing is prerendered static worker (see
packages/landing/src/worker.ts) — SSR head injection may require build-time prerender refactor OR moving blog to runtime SSR (breaks edge cache). Decision pending during implementation.
Acceptance Criteria
BDD scenarios
describe('Feature: SSR <head> injection for blog posts', () => {
describe('Given a published blog post at /blog/<slug>', () => {
describe('When the page is rendered SSR', () => {
it('then <title> and <meta name="description"> match frontmatter', () => {});
it('then <link rel="canonical"> is absolute and points to vertz.dev/blog/<slug>', () => {});
it('then OG tags present: og:title, og:description, og:image, og:url, og:type', () => {});
it('then a <script type="application/ld+json"> with BlogPosting + TechArticle is present', () => {});
it('then <link rel="alternate" type="application/rss+xml"> references /blog/feed.xml', () => {});
});
});
describe('Given the rendered HTML of one blog post', () => {
describe('When tested at Google Rich Results Test', () => {
it('then it passes with no errors', () => {});
});
});
});Checklist
Dependencies
Progress
Description
Wire per-page
<head>injection into the landing worker: canonical URL, Open Graph tags, Twitter card, and expanded JSON-LD (BlogPosting, TechArticle, SoftwareApplication, FAQPage). Without this, every blog post published is SEO-invisible and LLMs have no structured data to parse.Context
Part of GEO/SEO strategy v1 (28-day scope).
plans/geo-seo-strategy.mdplans/geo-seo-strategy/phase-01-foundation-infra.md→ Task 2packages/landing/src/worker.ts) — SSR head injection may require build-time prerender refactor OR moving blog to runtime SSR (breaks edge cache). Decision pending during implementation.Acceptance Criteria
BDD scenarios
Checklist
Dependencies
packages/landing/src/blog/seo/json-ld.ts)Progress