Fix critical SEO issues: OG image, meta alignment, privacy policy

- Convert OG image from SVG to PNG (social platforms don't render SVG)
- Update OG SVG tagline to match new copy
- Align pre-rendered titles and meta descriptions with React components
- Update noscript fallback to match new homepage copy
- Add privacy policy page with route, prerender, and noscript fallback
- Add privacy link to Footer component (new `links` prop)
- Add `dateModified` and `author.url` to BlogPosting JSON-LD schema
- Add `<lastmod>` to all sitemap URLs
- Update Organization schema description

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: gmoon

packages/ui/src/components/Footer.tsx

@@ -5,6 +5,7 @@ export interface FooterProps {
   repoUrl?: string
   repoLabel?: string
   orgName?: string
+  links?: { label: string; href: string }[]
 }
 
 const styles = {
@@ -23,7 +24,7 @@ const styles = {
   },
 }
 
-export function Footer({ repoUrl, repoLabel, orgName }: FooterProps) {
+export function Footer({ repoUrl, repoLabel, orgName, links }: FooterProps) {
   injectGlobalStyles()
   return (
     <footer style={styles.footer} data-fzui>
@@ -41,6 +42,18 @@ export function Footer({ repoUrl, repoLabel, orgName }: FooterProps) {
           <>Built with {repoLabel ?? 'Lattice'}.</>
         )}
       </p>
+      {links && links.length > 0 && (
+        <p>
+          {links.map((link, i) => (
+            <span key={link.href}>
+              {i > 0 && ' · '}
+              <a href={link.href} style={styles.link}>
+                {link.label}
+              </a>
+            </span>
+          ))}
+        </p>
+      )}
     </footer>
   )
 }

public/og-default.png

@@ -18,7 +18,7 @@ describe('pre-rendered homepage', () => {
 
   it('has correct title', () => {
     const html = readFileSync(file, 'utf-8')
-    expect(html).toContain('<title>Forkzero — Knowledge Coordination for AI-Native Teams</title>')
+    expect(html).toContain('<title>Lattice by Forkzero — Knowledge Graph for AI-Native Teams</title>')
   })
 
   it('has meta description', () => {
@@ -72,7 +72,7 @@ describe('pre-rendered getting-started', () => {
 
   it('has correct title', () => {
     const html = readFileSync(file, 'utf-8')
-    expect(html).toContain('<title>Getting Started — Forkzero</title>')
+    expect(html).toContain('<title>Get Started with Lattice — Forkzero</title>')
   })
 
   it('has meta description', () => {

public/og-default.svg

@@ -38,16 +38,22 @@ const routes: RouteMeta[] = [
   })),
   {
     path: '/getting-started',
-    title: 'Getting Started — Forkzero',
+    title: 'Get Started with Lattice — Forkzero',
     description: 'Install Lattice and start building a knowledge-coordinated codebase in under five minutes.',
     canonical: 'https://forkzero.ai/getting-started',
   },
+  {
+    path: '/privacy',
+    title: 'Privacy Policy — Forkzero',
+    description: 'Forkzero privacy policy. How we handle your data.',
+    canonical: 'https://forkzero.ai/privacy',
+  },
   // Homepage last — it overwrites dist/index.html (template is already in memory)
   {
     path: '/',
-    title: 'Forkzero — Knowledge Coordination for AI-Native Teams',
+    title: 'Lattice by Forkzero — Knowledge Graph for AI-Native Teams',
     description:
-      'Forkzero builds developer tools that connect research, strategy, requirements, and implementation into a traversable knowledge graph.',
+      'Lattice captures the research, decisions, and requirements behind your code in a Git-native knowledge graph. Any collaborator — human or AI — picks up where the last one left off.',
     canonical: 'https://forkzero.ai/',
   },
 ]
@@ -73,12 +79,12 @@ for (const route of routes) {
     `<meta property="og:description" content="${escapeAttr(route.description)}" />`,
     `<meta property="og:type" content="${ogType}" />`,
     `<meta property="og:url" content="${route.canonical}" />`,
-    `<meta property="og:image" content="https://forkzero.ai/og-default.svg" />`,
+    `<meta property="og:image" content="https://forkzero.ai/og-default.png" />`,
     `<meta property="og:site_name" content="Forkzero" />`,
     `<meta name="twitter:card" content="summary_large_image" />`,
     `<meta name="twitter:title" content="${escapeAttr(route.title)}" />`,
     `<meta name="twitter:description" content="${escapeAttr(route.description)}" />`,
-    `<meta name="twitter:image" content="https://forkzero.ai/og-default.svg" />`,
+    `<meta name="twitter:image" content="https://forkzero.ai/og-default.png" />`,
     `<link rel="canonical" href="${route.canonical}" />`,
   ].join('\n    ')
 
@@ -108,10 +114,12 @@ for (const route of routes) {
 
 // --- Generate sitemap.xml ---
 // Note: <changefreq> and <priority> are ignored by Google and omitted per best practice.
-const sitemapUrls: { loc: string; lastmod?: string }[] = [
-  { loc: 'https://forkzero.ai/' },
-  { loc: 'https://forkzero.ai/getting-started' },
-  { loc: 'https://forkzero.ai/blog' },
+const today = new Date().toISOString().split('T')[0]
+const latestPostDate = blogPosts.length > 0 ? blogPosts[0].date : today
+const sitemapUrls: { loc: string; lastmod: string }[] = [
+  { loc: 'https://forkzero.ai/', lastmod: today },
+  { loc: 'https://forkzero.ai/getting-started', lastmod: today },
+  { loc: 'https://forkzero.ai/blog', lastmod: latestPostDate },
   ...blogPosts.map((post) => ({
     loc: `https://forkzero.ai/blog/${post.slug}`,
     lastmod: post.date,
@@ -121,10 +129,7 @@ const sitemapUrls: { loc: string; lastmod?: string }[] = [
 const sitemapXml = [
   '<?xml version="1.0" encoding="UTF-8"?>',
   '<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">',
-  ...sitemapUrls.map((u) => {
-    const lastmod = u.lastmod ? `\n    <lastmod>${u.lastmod}</lastmod>` : ''
-    return `  <url>\n    <loc>${u.loc}</loc>${lastmod}\n  </url>`
-  }),
+  ...sitemapUrls.map((u) => `  <url>\n    <loc>${u.loc}</loc>\n    <lastmod>${u.lastmod}</lastmod>\n  </url>`),
   '</urlset>',
   '',
 ].join('\n')
@@ -144,13 +149,13 @@ function buildNoscript(route: RouteMeta): string | null {
       .join('\n')
     return wrap(
       [
-        `<h1>Forkzero — Knowledge Coordination for AI-Native Teams</h1>`,
-        `<p>Connect research, strategy, requirements, and implementation into a traversable knowledge graph.</p>`,
-        `<h2>Why Forkzero</h2>`,
+        `<h1>Your agent writes the code. Who remembers why?</h1>`,
+        `<p>The research, reasoning, and requirements behind your code vanish into chat logs. Lattice captures them in a Git-native knowledge graph — so any collaborator, human or AI, can pick up where the last one left off.</p>`,
+        `<h2>Why Lattice?</h2>`,
         `<ul>`,
-        `<li>Every decision traces back to its source</li>`,
-        `<li>Agents and humans share the same knowledge layer</li>`,
-        `<li>Context stays structured, not scattered</li>`,
+        `<li>Stop losing the &quot;why&quot; — every requirement traces back to the research that motivated it</li>`,
+        `<li>Requirements before code, not after — give your agent a spec to implement</li>`,
+        `<li>Onboard anyone in minutes — human or AI</li>`,
         `</ul>`,
         `<h2>Projects</h2>`,
         `<ul>${projectList}</ul>`,
@@ -181,6 +186,16 @@ function buildNoscript(route: RouteMeta): string | null {
     return wrap(`<h1>Blog</h1>${listHtml}`)
   }
 
+  if (route.path === '/privacy') {
+    return wrap(
+      [
+        `<h1>Privacy Policy</h1>`,
+        `<p>If you subscribe to our mailing list, we collect your email address. We do not use cookies, tracking pixels, or third-party analytics. Lattice is open-source software that runs entirely on your machine and does not collect telemetry.</p>`,
+        `<p>Contact: privacy@forkzero.ai</p>`,
+      ].join(''),
+    )
+  }
+
   // Blog post
   const post = blogPosts.find((p) => `/blog/${p.slug}` === route.path)
   if (post) {
@@ -214,7 +229,7 @@ function buildJsonLd(route: RouteMeta): string {
       },
       sameAs: ['https://github.com/forkzero'],
       description:
-        'Forkzero builds developer tools that connect research, strategy, requirements, and implementation into a traversable knowledge graph.',
+        'Forkzero builds developer tools for AI-native teams. Lattice captures research, decisions, and requirements in a Git-native knowledge graph.',
     })
     schemas.push({
       '@context': 'https://schema.org',
@@ -266,10 +281,12 @@ function buildJsonLd(route: RouteMeta): string {
         headline: post.title,
         description: post.excerpt,
         datePublished: post.date,
-        image: 'https://forkzero.ai/og-default.svg',
+        dateModified: post.date,
+        image: 'https://forkzero.ai/og-default.png',
         author: {
           '@type': 'Person',
           name: post.author.name,
+          ...(post.author.github ? { url: post.author.github } : {}),
         },
         publisher: {
           '@type': 'Organization',
@@ -322,6 +339,24 @@ function buildJsonLd(route: RouteMeta): string {
     })
   }
 
+  if (route.path === '/privacy') {
+    schemas.push({
+      '@context': 'https://schema.org',
+      '@type': 'WebPage',
+      name: 'Privacy Policy — Forkzero',
+      description: route.description,
+      url: route.canonical,
+    })
+    schemas.push({
+      '@context': 'https://schema.org',
+      '@type': 'BreadcrumbList',
+      itemListElement: [
+        { '@type': 'ListItem', position: 1, name: 'Home', item: 'https://forkzero.ai/' },
+        { '@type': 'ListItem', position: 2, name: 'Privacy Policy', item: 'https://forkzero.ai/privacy' },
+      ],
+    })
+  }
+
   if (schemas.length === 0) return ''
 
   return schemas.map((s) => `<script type="application/ld+json">${JSON.stringify(s)}</script>`).join('\n    ')

scripts/prerender.test.ts

@@ -35,6 +35,14 @@ describe('parseRoute', () => {
     expect(parseRoute('/design-system/')).toEqual({ page: 'design-system' })
   })
 
+  it('returns privacy for /privacy', () => {
+    expect(parseRoute('/privacy')).toEqual({ page: 'privacy' })
+  })
+
+  it('returns privacy for /privacy/ with trailing slash', () => {
+    expect(parseRoute('/privacy/')).toEqual({ page: 'privacy' })
+  })
+
   it('returns blog listing for /blog', () => {
     expect(parseRoute('/blog')).toEqual({ page: 'blog' })
   })

scripts/prerender.ts

@@ -3,13 +3,15 @@ import { ReaderPage } from './pages/ReaderPage'
 import { BlogPage } from './pages/BlogPage'
 import { GettingStartedPage } from './pages/GettingStartedPage'
 import { DesignSystemPage } from './pages/DesignSystemPage'
+import { PrivacyPage } from './pages/PrivacyPage'
 
-type PageRoute = 'home' | 'reader' | 'getting-started' | 'blog' | 'blog-post' | 'design-system'
+type PageRoute = 'home' | 'reader' | 'getting-started' | 'blog' | 'blog-post' | 'design-system' | 'privacy'
 
 export function parseRoute(path: string): { page: PageRoute; slug?: string } {
   if (path === '/reader' || path === '/reader/') return { page: 'reader' }
   if (path === '/getting-started' || path === '/getting-started/') return { page: 'getting-started' }
   if (path === '/design-system' || path === '/design-system/') return { page: 'design-system' }
+  if (path === '/privacy' || path === '/privacy/') return { page: 'privacy' }
   if (path === '/blog' || path === '/blog/') return { page: 'blog' }
   if (path.startsWith('/blog/')) {
     const slug = path.replace(/^\/blog\//, '').replace(/\/$/, '')
@@ -28,6 +30,8 @@ export function App() {
       return <GettingStartedPage />
     case 'design-system':
       return <DesignSystemPage />
+    case 'privacy':
+      return <PrivacyPage />
     case 'blog':
       return <BlogPage />
     case 'blog-post':

src/App.test.ts

@@ -731,15 +731,15 @@ function BlogListing() {
     )
     setOgTag('og:type', 'website')
     setOgTag('og:url', 'https://forkzero.ai/blog')
-    setOgTag('og:image', 'https://forkzero.ai/og-default.svg')
+    setOgTag('og:image', 'https://forkzero.ai/og-default.png')
     setOgTag('og:site_name', 'Forkzero')
     setMetaTag('twitter:card', 'summary_large_image')
     setMetaTag('twitter:title', 'Blog \u2014 Forkzero')
     setMetaTag(
       'twitter:description',
       'Technical writing on knowledge coordination, context engineering, and AI-first developer tooling.',
     )
-    setMetaTag('twitter:image', 'https://forkzero.ai/og-default.svg')
+    setMetaTag('twitter:image', 'https://forkzero.ai/og-default.png')
     setCanonical('https://forkzero.ai/blog')
   }, [])
 
@@ -764,7 +764,7 @@ function BlogListing() {
           </a>
         ))}
       </div>
-      <Footer repoUrl={GITHUB_REPO_URL} />
+      <Footer repoUrl={GITHUB_REPO_URL} links={[{ label: 'Privacy', href: '/privacy' }]} />
     </div>
   )
 }
@@ -779,12 +779,12 @@ function BlogPostView({ post }: { post: BlogPost }) {
     setOgTag('og:description', post.excerpt)
     setOgTag('og:type', 'article')
     setOgTag('og:url', `https://forkzero.ai/blog/${post.slug}`)
-    setOgTag('og:image', 'https://forkzero.ai/og-default.svg')
+    setOgTag('og:image', 'https://forkzero.ai/og-default.png')
     setOgTag('og:site_name', 'Forkzero')
     setMetaTag('twitter:card', 'summary_large_image')
     setMetaTag('twitter:title', post.title)
     setMetaTag('twitter:description', post.excerpt)
-    setMetaTag('twitter:image', 'https://forkzero.ai/og-default.svg')
+    setMetaTag('twitter:image', 'https://forkzero.ai/og-default.png')
     setCanonical(`https://forkzero.ai/blog/${post.slug}`)
   }, [post])
 
@@ -813,7 +813,7 @@ function BlogPostView({ post }: { post: BlogPost }) {
           <BlogComments slug={post.slug} />
         </div>
       </div>
-      <Footer repoUrl={GITHUB_REPO_URL} />
+      <Footer repoUrl={GITHUB_REPO_URL} links={[{ label: 'Privacy', href: '/privacy' }]} />
     </div>
   )
 }
@@ -833,7 +833,7 @@ function BlogNotFound() {
           Back to blog
         </a>
       </div>
-      <Footer repoUrl={GITHUB_REPO_URL} />
+      <Footer repoUrl={GITHUB_REPO_URL} links={[{ label: 'Privacy', href: '/privacy' }]} />
     </div>
   )
 }

src/App.tsx

@@ -460,15 +460,15 @@ export function GettingStartedPage() {
     )
     setOgTag('og:type', 'website')
     setOgTag('og:url', 'https://forkzero.ai/getting-started')
-    setOgTag('og:image', 'https://forkzero.ai/og-default.svg')
+    setOgTag('og:image', 'https://forkzero.ai/og-default.png')
     setOgTag('og:site_name', 'Forkzero')
     setMetaTag('twitter:card', 'summary_large_image')
     setMetaTag('twitter:title', 'Get Started with Lattice — Forkzero')
     setMetaTag(
       'twitter:description',
       'Install Lattice and start building a knowledge-coordinated codebase in under five minutes.',
     )
-    setMetaTag('twitter:image', 'https://forkzero.ai/og-default.svg')
+    setMetaTag('twitter:image', 'https://forkzero.ai/og-default.png')
   }, [])
 
   return (
@@ -773,7 +773,7 @@ lattice drift`}
         </section>
       </div>
 
-      <Footer repoUrl={GITHUB_REPO_URL} />
+      <Footer repoUrl={GITHUB_REPO_URL} links={[{ label: 'Privacy', href: '/privacy' }]} />
     </div>
   )
 }

src/pages/BlogPage.tsx

@@ -856,12 +856,12 @@ export function HomePage() {
     setOgTag('og:description', metaDescription)
     setOgTag('og:type', 'website')
     setOgTag('og:url', 'https://forkzero.ai/')
-    setOgTag('og:image', 'https://forkzero.ai/og-default.svg')
+    setOgTag('og:image', 'https://forkzero.ai/og-default.png')
     setOgTag('og:site_name', 'Forkzero')
     setMetaTag('twitter:card', 'summary_large_image')
     setMetaTag('twitter:title', metaTitle)
     setMetaTag('twitter:description', metaDescription)
-    setMetaTag('twitter:image', 'https://forkzero.ai/og-default.svg')
+    setMetaTag('twitter:image', 'https://forkzero.ai/og-default.png')
   }, [])
 
   return (
@@ -876,7 +876,7 @@ export function HomePage() {
       <EmailCapture />
       <FeaturedArticle />
       <Projects />
-      <Footer repoUrl={GITHUB_REPO_URL} />
+      <Footer repoUrl={GITHUB_REPO_URL} links={[{ label: 'Privacy', href: '/privacy' }]} />
     </>
   )
 }