seo+geo: per-user metadata, WebSite SearchAction, BreadcrumbList, expanded sitemap

Now that the site is in Google Search Console, the biggest gaps are
closed in one pass.

/user/[username] (the largest indexable surface) was a pure client
component with zero metadata. Every graveyard URL was sharing the
homepage title in Google. Split into:
  - page.tsx: server component with generateMetadata, sanitizes the
    username and emits per-user title, description, canonical, OG.
  - UserPageContent.tsx: the original client UI, untouched logic.

Root layout JSON-LD expanded into a graph with three linked entities:
  - WebSite: adds SearchAction so Google can render a sitelinks search
    box pointing at /?repo={query}. Free traffic capture for any
    repo-style search.
  - WebApplication: kept, now uses @id refs to share creator/publisher.
  - Organization: gains sameAs with the public social handles so
    Google can verify Dot Systems identity across X / IG / GitHub.

Each subpage (about, faq, legal, pricing) now emits a BreadcrumbList
JSON-LD via a tiny shared BreadcrumbJsonLd component. Helps Google
build a richer SERP path.

Sitemap gains six sample /user/* entries (dotsystemsdevs plus famous
casualty orgs like atom, angular, apache, facebookarchive, YahooArchive)
so crawlers discover the dynamic route shape and we don't rely on
SearchConsole to guess that /user/X exists.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

Author: dotsystemsdevs

src/app/about/page.tsx

@@ -1,5 +1,6 @@
 import type { Metadata } from 'next'
 import AboutContent from './AboutContent'
+import BreadcrumbJsonLd from '@/components/BreadcrumbJsonLd'
 
 export const metadata: Metadata = {
   title: 'About · Commitment Issues · How It Works',
@@ -13,5 +14,10 @@ export const metadata: Metadata = {
 }
 
 export default function AboutPage() {
-  return <AboutContent />
+  return (
+    <>
+      <BreadcrumbJsonLd trail={[{ name: 'About', path: '/about' }]} />
+      <AboutContent />
+    </>
+  )
 }

src/app/faq/page.tsx

@@ -1,5 +1,6 @@
 import type { Metadata } from 'next'
 import FAQContent from './FAQContent'
+import BreadcrumbJsonLd from '@/components/BreadcrumbJsonLd'
 
 export const metadata: Metadata = {
   title: 'FAQ · Commitment Issues',
@@ -85,6 +86,7 @@ function FAQJsonLd() {
 export default function FAQPage() {
   return (
     <>
+      <BreadcrumbJsonLd trail={[{ name: 'FAQ', path: '/faq' }]} />
       <FAQJsonLd />
       <FAQContent items={FAQ} />
     </>

src/app/layout.tsx

@@ -67,8 +67,25 @@ export const metadata: Metadata = {
 const jsonLd = {
   '@context': 'https://schema.org',
   '@graph': [
+    {
+      '@type': 'WebSite',
+      '@id': 'https://commitmentissues.dev/#website',
+      url: 'https://commitmentissues.dev',
+      name: 'Commitment Issues',
+      description: 'Death certificate generator for abandoned GitHub repositories.',
+      publisher: { '@id': 'https://commitmentissues.dev/#org' },
+      potentialAction: {
+        '@type': 'SearchAction',
+        target: {
+          '@type': 'EntryPoint',
+          urlTemplate: 'https://commitmentissues.dev/?repo={search_term_string}',
+        },
+        'query-input': 'required name=search_term_string',
+      },
+    },
     {
       '@type': 'WebApplication',
+      '@id': 'https://commitmentissues.dev/#app',
       name: 'Commitment Issues',
       alternateName: 'commitmentissues.dev',
       description: 'Free tool that generates official death certificates for abandoned GitHub repos. Paste any public repo URL to see the cause of death, last commit as last words, and full repo stats.',
@@ -83,12 +100,18 @@ const jsonLd = {
         'README badge embed',
       ],
       offers: { '@type': 'Offer', price: '0', priceCurrency: 'USD' },
-      creator: { '@type': 'Organization', name: 'Dot Systems', url: 'https://github.com/dotsystemsdevs' },
+      creator: { '@id': 'https://commitmentissues.dev/#org' },
     },
     {
       '@type': 'Organization',
+      '@id': 'https://commitmentissues.dev/#org',
       name: 'Dot Systems',
       url: 'https://github.com/dotsystemsdevs',
+      sameAs: [
+        'https://github.com/dotsystemsdevs',
+        'https://x.com/Dotsystemsdevs',
+        'https://www.instagram.com/dotsystemsdevs/',
+      ],
     },
   ],
 }

src/app/legal/page.tsx

@@ -1,5 +1,6 @@
 import type { Metadata } from 'next'
 import LegalContent from './legalContent'
+import BreadcrumbJsonLd from '@/components/BreadcrumbJsonLd'
 
 export const metadata: Metadata = {
   title: 'Legal · Commitment Issues',
@@ -13,6 +14,11 @@ export const metadata: Metadata = {
 }
 
 export default function LegalPage() {
-  return <LegalContent />
+  return (
+    <>
+      <BreadcrumbJsonLd trail={[{ name: 'Legal', path: '/legal' }]} />
+      <LegalContent />
+    </>
+  )
 }
 

src/app/pricing/page.tsx

@@ -1,5 +1,6 @@
 import type { Metadata } from 'next'
 import PricingContent from './PricingContent'
+import BreadcrumbJsonLd from '@/components/BreadcrumbJsonLd'
 
 export const metadata: Metadata = {
   title: 'Pricing · Commitment Issues · Death Is Free',
@@ -13,5 +14,10 @@ export const metadata: Metadata = {
 }
 
 export default function PricingPage() {
-  return <PricingContent />
+  return (
+    <>
+      <BreadcrumbJsonLd trail={[{ name: 'Pricing', path: '/pricing' }]} />
+      <PricingContent />
+    </>
+  )
 }

src/app/sitemap.ts

@@ -2,6 +2,17 @@ import { MetadataRoute } from 'next'
 
 const BASE_URL = 'https://commitmentissues.dev'
 
+// Sample user-graveyard URLs to expose the dynamic /user/[name] route shape
+// to crawlers. These pages have their own metadata (per-user title/description).
+const SAMPLE_USERS = [
+  'dotsystemsdevs',
+  'atom',
+  'angular',
+  'apache',
+  'facebookarchive',
+  'YahooArchive',
+]
+
 export default function sitemap(): MetadataRoute.Sitemap {
   const now = new Date()
   return [
@@ -10,5 +21,11 @@ export default function sitemap(): MetadataRoute.Sitemap {
     { url: `${BASE_URL}/pricing`, lastModified: now, changeFrequency: 'monthly', priority: 0.7 },
     { url: `${BASE_URL}/about`,   lastModified: now, changeFrequency: 'monthly', priority: 0.6 },
     { url: `${BASE_URL}/legal`,   lastModified: now, changeFrequency: 'yearly',  priority: 0.3 },
+    ...SAMPLE_USERS.map((u) => ({
+      url: `${BASE_URL}/user/${u}`,
+      lastModified: now,
+      changeFrequency: 'weekly' as const,
+      priority: 0.5,
+    })),
   ]
 }

src/app/user/[username]/UserPageContent.tsx

@@ -0,0 +1,59 @@
+'use client'
+
+import { useEffect, useState } from 'react'
+import { useParams, useRouter } from 'next/navigation'
+import type { UserRepoSummary } from '@/lib/types'
+import UserDashboard from '@/components/UserDashboard'
+import LoadingState from '@/components/LoadingState'
+import SubpageShell from '@/components/SubpageShell'
+
+const MONO = `var(--font-courier), system-ui, sans-serif`
+
+export default function UserPageContent() {
+  const params = useParams()
+  const router = useRouter()
+  const username = typeof params.username === 'string' ? params.username : ''
+
+  const [repos, setRepos]   = useState<UserRepoSummary[] | null>(null)
+  const [error, setError]   = useState<string | null>(null)
+  const [loading, setLoading] = useState(true)
+
+  useEffect(() => {
+    if (!username) return
+    setLoading(true)
+    setError(null)
+    fetch(`/api/user?username=${encodeURIComponent(username)}`)
+      .then(r => r.json())
+      .then((d: { repos?: UserRepoSummary[]; error?: string }) => {
+        if (d.error) { setError(d.error); return }
+        setRepos(d.repos ?? [])
+      })
+      .catch(() => setError('Something went wrong. Try again.'))
+      .finally(() => setLoading(false))
+  }, [username])
+
+  return (
+    <SubpageShell
+      title={undefined}
+      subtitle={null}
+      microcopy={null}
+      hideHero
+    >
+      {loading && <LoadingState />}
+
+      {error && (
+        <div style={{ textAlign: 'center', padding: '40px 0' }}>
+          <p style={{ fontFamily: MONO, fontSize: '13px', color: 'var(--c-red)', marginBottom: '20px' }}>{error}</p>
+          <button
+            onClick={() => router.push('/')}
+            style={{ fontFamily: MONO, fontSize: '13px', fontWeight: 700, background: 'none', border: 'none', textDecoration: 'underline', textUnderlineOffset: '3px', color: 'var(--c-ink)', cursor: 'pointer', minHeight: '44px', padding: '10px 0' }}
+          >
+            ← examine another subject
+          </button>
+        </div>
+      )}
+
+      {repos && !loading && <UserDashboard repos={repos} username={username} />}
+    </SubpageShell>
+  )
+}

src/app/user/[username]/page.tsx

@@ -1,59 +1,51 @@
-'use client'
+import type { Metadata } from 'next'
+import UserPageContent from './UserPageContent'
 
-import { useEffect, useState } from 'react'
-import { useParams, useRouter } from 'next/navigation'
-import type { UserRepoSummary } from '@/lib/types'
-import UserDashboard from '@/components/UserDashboard'
-import LoadingState from '@/components/LoadingState'
-import SubpageShell from '@/components/SubpageShell'
+const VALID_USERNAME = /^[a-zA-Z0-9_.-]+$/
 
-const MONO = `var(--font-courier), system-ui, sans-serif`
-
-export default function UserPage() {
-  const params = useParams()
-  const router = useRouter()
-  const username = typeof params.username === 'string' ? params.username : ''
-
-  const [repos, setRepos]   = useState<UserRepoSummary[] | null>(null)
-  const [error, setError]   = useState<string | null>(null)
-  const [loading, setLoading] = useState(true)
-
-  useEffect(() => {
-    if (!username) return
-    setLoading(true)
-    setError(null)
-    fetch(`/api/user?username=${encodeURIComponent(username)}`)
-      .then(r => r.json())
-      .then((d: { repos?: UserRepoSummary[]; error?: string }) => {
-        if (d.error) { setError(d.error); return }
-        setRepos(d.repos ?? [])
-      })
-      .catch(() => setError('Something went wrong. Try again.'))
-      .finally(() => setLoading(false))
-  }, [username])
-
-  return (
-    <SubpageShell
-      title={undefined}
-      subtitle={null}
-      microcopy={null}
-      hideHero
-    >
-      {loading && <LoadingState />}
+function sanitizeUsername(raw: string): string {
+  const trimmed = raw.slice(0, 39)
+  return VALID_USERNAME.test(trimmed) ? trimmed : ''
+}
 
-      {error && (
-        <div style={{ textAlign: 'center', padding: '40px 0' }}>
-          <p style={{ fontFamily: MONO, fontSize: '13px', color: '#8B0000', marginBottom: '20px' }}>{error}</p>
-          <button
-            onClick={() => router.push('/')}
-            style={{ fontFamily: MONO, fontSize: '13px', fontWeight: 700, background: 'none', border: 'none', textDecoration: 'underline', textUnderlineOffset: '3px', color: '#160A06', cursor: 'pointer', minHeight: '44px', padding: '10px 0' }}
-          >
-            ← examine another subject
-          </button>
-        </div>
-      )}
+export async function generateMetadata(
+  { params }: { params: Promise<{ username: string }> }
+): Promise<Metadata> {
+  const { username } = await params
+  const safe = sanitizeUsername(username)
+
+  if (!safe) {
+    return {
+      title: 'Graveyard · Commitment Issues',
+      description: 'Browse the GitHub graveyard for any developer on Commitment Issues.',
+      robots: { index: false, follow: true },
+    }
+  }
+
+  const title = `@${safe}'s GitHub Graveyard · Commitment Issues`
+  const description = `See how many of @${safe}'s GitHub repositories are alive, on life support, or deceased. Free abandonment analysis with death certificates for any developer's projects.`
+  const canonical = `https://commitmentissues.dev/user/${safe}`
+
+  return {
+    title,
+    description,
+    alternates: { canonical },
+    openGraph: {
+      title,
+      description,
+      url: canonical,
+      type: 'profile',
+      images: [{ url: '/opengraph-image', width: 1200, height: 630 }],
+    },
+    twitter: {
+      card: 'summary_large_image',
+      title,
+      description,
+      images: ['/opengraph-image'],
+    },
+  }
+}
 
-      {repos && !loading && <UserDashboard repos={repos} username={username} />}
-    </SubpageShell>
-  )
+export default function UserPage() {
+  return <UserPageContent />
 }

src/components/BreadcrumbJsonLd.tsx

@@ -0,0 +1,25 @@
+const BASE = 'https://commitmentissues.dev'
+
+type Crumb = { name: string; path: string }
+
+export default function BreadcrumbJsonLd({ trail }: { trail: Crumb[] }) {
+  const data = {
+    '@context': 'https://schema.org',
+    '@type': 'BreadcrumbList',
+    itemListElement: [
+      { '@type': 'ListItem', position: 1, name: 'Home', item: BASE },
+      ...trail.map((c, i) => ({
+        '@type': 'ListItem',
+        position: i + 2,
+        name: c.name,
+        item: `${BASE}${c.path}`,
+      })),
+    ],
+  }
+  return (
+    <script
+      type="application/ld+json"
+      dangerouslySetInnerHTML={{ __html: JSON.stringify(data) }}
+    />
+  )
+}