diff --git a/app/AGENTS.md b/app/AGENTS.md
index 2775daf..ccc51b3 100644
--- a/app/AGENTS.md
+++ b/app/AGENTS.md
@@ -3,8 +3,10 @@
- `page.tsx` – the canonical unified Stripe history timeline.
- `history/` – category pages, the appearances projection, annual-volume and valuation pages, and shared timeline rendering.
- `data/` – the crawlable history and research dataset index.
-- `about/` – sourcing, review, independence, corrections, and privacy.
-- `site.ts`, `site-header.tsx`, and `site-footer.tsx` – canonical identity and shared page chrome.
+- `about/`, `contact/`, and `privacy/` – sourcing, review, independence, corrections, public contact channels, and privacy.
+- `llms.txt/` – the agent index with when-to-use guidance.
+- Root `proxy.ts` – Accept negotiation that serves Markdown for the same public URLs.
+- `site.ts`, `site-copy.ts`, `site-header.tsx`, and `site-footer.tsx` – canonical identity, shared editorial copy, and shared page chrome.
- `analytics.ts`, `posthog.ts`, and `posthog-analytics.tsx` – the finite public-route analytics contract, strict PostHog boundary, and client provider.
- `layout.tsx`, `globals.css`, and `support/` – the document, appearance, structured-data, and portable styling boundaries.
- `robots.ts`, `sitemap.ts`, `manifest.ts`, and `opengraph-image.tsx` – public discovery and sharing surfaces.
diff --git a/app/about/page.test.tsx b/app/about/page.test.tsx
index 069b63b..961042d 100644
--- a/app/about/page.test.tsx
+++ b/app/about/page.test.tsx
@@ -27,6 +27,8 @@ describe("stripedex.com about page", () => {
expect(html).toContain('aria-label="Appearance: System"');
expect(html).toContain('href="https://hraness.com/"');
expect(html).toContain('href="https://github.com/hraness/stripedex"');
+ expect(html).toContain('href="/contact"');
+ expect(html).toContain('href="/privacy"');
expect(html).not.toContain("Atom feed");
expect(html).not.toContain("news summaries");
expect(html).toContain('type="application/ld+json"');
diff --git a/app/about/page.tsx b/app/about/page.tsx
index fc2b5d1..3e6445d 100644
--- a/app/about/page.tsx
+++ b/app/about/page.tsx
@@ -87,7 +87,9 @@ export default function AboutPage() {
Published and maintained by Hraness. To
suggest a correction, add a source, or improve the project, open an
issue or contribution in the{" "}
- Stripedex repository.
+ Stripedex repository. The same
+ public channels are listed on the{" "}
+ contact page.
Privacy
@@ -105,6 +107,10 @@ export default function AboutPage() {
no user accounts or authentication. Requests are still subject to the
ordinary logs and security controls of the hosting provider.
+
+ The dedicated privacy page repeats this
+ policy for agents and other readers who look for /privacy.
+
");
+ expect(html).toContain("https://github.com/hraness/stripedex/issues");
+ expect(html).toContain("private vulnerability reporting");
+ expect(html).toContain("not affiliated with, endorsed by, or operated by");
+ expect(html).toContain("There is no reader account, contact form, or product inbox");
+ expect(html).not.toContain("@stripedex.com");
+ expect(html).toContain('aria-label="Appearance: System"');
+ expect(visibleText(html).length).toBeGreaterThan(500);
+ });
+});
diff --git a/app/contact/page.tsx b/app/contact/page.tsx
new file mode 100644
index 0000000..b2a40af
--- /dev/null
+++ b/app/contact/page.tsx
@@ -0,0 +1,94 @@
+import { JsonLdScript } from "@hraness/web-discovery/json-ld";
+import type { Metadata } from "next";
+import Link from "next/link";
+
+import { breadcrumbJsonLd } from "../seo";
+import { SiteFooter } from "../site-footer";
+import { SiteHeader } from "../site-header";
+import {
+ contactDescription,
+ contactSocialTitle,
+ contactTitle,
+ independenceSentence,
+} from "../site-copy";
+import {
+ GITHUB_REPOSITORY_URL,
+ HRANESS_URL,
+ site,
+ socialMetadata,
+} from "../site";
+
+export const dynamic = "force-static";
+
+export const metadata: Metadata = {
+ title: contactTitle,
+ description: contactDescription,
+ alternates: { canonical: "/contact" },
+ ...socialMetadata(contactSocialTitle, contactDescription, "/contact", {
+ alt: `Contact channels for the independent Stripe company history at ${site.domain}`,
+ }),
+};
+
+export default function ContactPage() {
+ return (
+
+
+
+
+
+
+
Contact {site.domain}
+ public channels
+
+
Corrections and sources
+
+ Use public GitHub issues for ordinary historical corrections, missing
+ events, stronger sources, and focused software improvements. Include
+ the event date, a concise factual claim, its category, the proposed
+ confidence and status, and at least one source URL. Prefer primary
+ sources. If a claim was only proposed or reported, keep that
+ uncertainty in the record.
+
+ Report suspected vulnerabilities through GitHub's private
+ vulnerability reporting for this repository. Do not include sensitive
+ details in a public issue.
+
+
Publisher
+
+ There is no reader account, contact form, or product inbox on{" "}
+ {site.domain}. The project does not process payments, issue API keys,
+ or operate a Stripe integration. {independenceSentence}
+
+
+ Published and maintained by Hraness. The
+ complete sourced records and website code are in the{" "}
+ Stripedex repository. Read{" "}
+ about for editorial method and{" "}
+ privacy for analytics limits.
+
+
+
+
+ );
+}
diff --git a/app/layout.tsx b/app/layout.tsx
index 3041e26..816fe7e 100644
--- a/app/layout.tsx
+++ b/app/layout.tsx
@@ -9,7 +9,7 @@ import type { Metadata, Viewport } from "next";
import type { ReactNode } from "react";
import "./globals.css";
import { PostHogAnalytics } from "./posthog-analytics";
-import { websiteJsonLd } from "./seo";
+import { siteOrganizationJsonLd, websiteJsonLd } from "./seo";
import { SITE_ORIGIN, site } from "./site";
export const metadata: Metadata = {
@@ -49,7 +49,10 @@ export default function RootLayout({ children }: Readonly<{ children: ReactNode
return (
-
+ {
+ test("serves the agent index as plain text", async () => {
+ const response = await GET();
+ const body = await response.text();
+ expect(response.status).toBe(200);
+ expect(response.headers.get("content-type")).toBe("text/plain; charset=utf-8");
+ expect(body).toContain("## When to use this");
+ expect(body).toContain("# Stripedex");
+ });
+});
diff --git a/app/llms.txt/route.ts b/app/llms.txt/route.ts
new file mode 100644
index 0000000..f0feffa
--- /dev/null
+++ b/app/llms.txt/route.ts
@@ -0,0 +1,12 @@
+import { llmsTxt } from "@/lib/llms-txt";
+
+export const dynamic = "force-static";
+
+export async function GET() {
+ return new Response(await llmsTxt(), {
+ headers: {
+ "Content-Type": "text/plain; charset=utf-8",
+ "Cache-Control": "public, max-age=0, must-revalidate",
+ },
+ });
+}
diff --git a/app/metadata.test.ts b/app/metadata.test.ts
index ab4b283..7915bbf 100644
--- a/app/metadata.test.ts
+++ b/app/metadata.test.ts
@@ -37,6 +37,8 @@ describe("stripedex.com public identity", () => {
`${SITE_ORIGIN}/history/payment-volume`,
`${SITE_ORIGIN}/history/valuation`,
`${SITE_ORIGIN}/about`,
+ `${SITE_ORIGIN}/contact`,
+ `${SITE_ORIGIN}/privacy`,
`${SITE_ORIGIN}/data`,
...timelineCategoryIds.map((id) => `${SITE_ORIGIN}/history/${id}`),
]));
@@ -99,6 +101,14 @@ describe("stripedex.com public identity", () => {
headers: [{ key: "X-Robots-Tag", value: "noindex, follow" }],
source: "/research/:path*",
});
+ expect(await nextConfig.headers?.()).toContainEqual({
+ headers: [{ key: "Vary", value: "Accept" }],
+ source: "/",
+ });
+ expect(await nextConfig.headers?.()).toContainEqual({
+ headers: [{ key: "Vary", value: "Accept" }],
+ source: "/:path*",
+ });
});
test("redirects former and www hosts directly to the canonical origin", async () => {
diff --git a/app/not-found.tsx b/app/not-found.tsx
index 1ec37d0..7ba78cd 100644
--- a/app/not-found.tsx
+++ b/app/not-found.tsx
@@ -4,9 +4,11 @@ import Link from "next/link";
import { SiteFooter } from "./site-footer";
import { SiteHeader } from "./site-header";
-
-const notFoundTitle = "Page not found";
-const notFoundDescription = "The requested Stripe history page does not exist.";
+import {
+ notFoundDescription,
+ notFoundTitle,
+ recoveryLinks,
+} from "./site-copy";
export const metadata: Metadata = {
title: notFoundTitle,
@@ -21,7 +23,16 @@ export default function NotFound() {
');
+ expect(html).toContain("anonymous, cookieless pageview events for public pages");
+ expect(html).toContain("does not save an analytics cookie or identifier");
+ expect(html).toContain("no user accounts or authentication");
+ expect(html).toContain('href="/contact"');
+ expect(html).toContain('aria-label="Appearance: System"');
+ expect(visibleText(html).length).toBeGreaterThan(500);
+ });
+});
diff --git a/app/privacy/page.tsx b/app/privacy/page.tsx
new file mode 100644
index 0000000..de51f2c
--- /dev/null
+++ b/app/privacy/page.tsx
@@ -0,0 +1,84 @@
+import { JsonLdScript } from "@hraness/web-discovery/json-ld";
+import type { Metadata } from "next";
+import Link from "next/link";
+
+import { breadcrumbJsonLd } from "../seo";
+import { SiteFooter } from "../site-footer";
+import { SiteHeader } from "../site-header";
+import {
+ privacyDescription,
+ privacySocialTitle,
+ privacyTitle,
+} from "../site-copy";
+import { GITHUB_REPOSITORY_URL, site, socialMetadata } from "../site";
+
+export const dynamic = "force-static";
+
+export const metadata: Metadata = {
+ title: privacyTitle,
+ description: privacyDescription,
+ alternates: { canonical: "/privacy" },
+ ...socialMetadata(privacySocialTitle, privacyDescription, "/privacy", {
+ alt: `Privacy practices for the independent Stripe company history at ${site.domain}`,
+ }),
+};
+
+export default function PrivacyPage() {
+ return (
+
+
+
+
+
+
+
{privacyTitle}
+ public pages
+
+
+ The site sends anonymous, cookieless pageview events for public pages
+ to PostHog. Each event contains the normalized public page path, its
+ page category, a site identifier, an analytics schema version, and
+ PostHog's cookieless marker. It excludes query strings, URL
+ fragments, referrer properties, account data, and user content. The
+ browser does not save an analytics cookie or identifier.
+
+
+ The site does not use autocapture, session replay, heatmaps, surveys,
+ feature flags, performance monitoring, or user profiles, and it has
+ no user accounts or authentication. Requests are still subject to the
+ ordinary logs and security controls of the hosting provider.
+
+
+ {site.domain} does not sell personal data, does not run advertising
+ pixels, and does not keep a reader profile. Appearance preferences
+ stay in the browser. Machine-readable copies of the public pages are
+ available as Markdown when a client sends{" "}
+ Accept: text/markdown, and the authored YAML records
+ remain downloadable from the{" "}
+ dataset index.
+
+
+ Questions about this policy belong on the{" "}
+ contact page or in the{" "}
+ Stripedex repository. The broader
+ sourcing and independence statement lives on the{" "}
+ about page.
+
+
+
+
+ );
+}
diff --git a/app/runtime-surfaces.test.tsx b/app/runtime-surfaces.test.tsx
index 903fb19..bdc11c4 100644
--- a/app/runtime-surfaces.test.tsx
+++ b/app/runtime-surfaces.test.tsx
@@ -42,6 +42,11 @@ describe("standalone runtime surfaces", () => {
expect(loading).toContain('role="status"');
expect(notFound).toContain("Page not found");
expect(notFound).toContain('href="/"');
+ expect(notFound).toContain('href="/llms.txt"');
+ expect(notFound).toContain('href="/sitemap.xml"');
+ expect(notFound).toContain('href="/about"');
+ expect(notFound).toContain('href="/contact"');
+ expect(notFound).toContain('href="/privacy"');
expect(loading.match(/data-presentation="menu"/gu)).toHaveLength(1);
expect(notFound.match(/data-presentation="menu"/gu)).toHaveLength(1);
expect(notFound).toContain('aria-label="hraness"');
diff --git a/app/seo.test.ts b/app/seo.test.ts
index af3b4df..9570d17 100644
--- a/app/seo.test.ts
+++ b/app/seo.test.ts
@@ -8,6 +8,7 @@ import {
breadcrumbJsonLd,
historyCollectionJsonLd,
historyDatasetJsonLd,
+ siteOrganizationJsonLd,
websiteJsonLd,
} from "./seo";
@@ -31,6 +32,16 @@ describe("stripedex.com structured discovery", () => {
about: { "@type": "Organization", name: "Stripe" },
publisher: { name: "Hraness" },
});
+ expect(siteOrganizationJsonLd()).toMatchObject({
+ "@type": "Organization",
+ "@id": "https://stripedex.com/#organization",
+ name: "Stripedex",
+ url: "https://stripedex.com/",
+ sameAs: ["https://github.com/hraness/stripedex"],
+ parentOrganization: { name: "Hraness", url: "https://hraness.com/" },
+ });
+ expect(siteOrganizationJsonLd()).not.toHaveProperty("address");
+ expect(siteOrganizationJsonLd()).not.toHaveProperty("contactPoint");
});
test("describes the open YAML records as a truthful dataset", async () => {
diff --git a/app/seo.ts b/app/seo.ts
index 1d07be0..912b026 100644
--- a/app/seo.ts
+++ b/app/seo.ts
@@ -24,6 +24,20 @@ const publisherJsonLd = {
sameAs: ["https://github.com/hraness"],
} as const;
+export function siteOrganizationJsonLd() {
+ return {
+ "@context": "https://schema.org",
+ "@type": "Organization",
+ "@id": `${SITE_ORIGIN}/#organization`,
+ name: site.name,
+ alternateName: site.domain,
+ description: site.description,
+ url: `${SITE_ORIGIN}/`,
+ sameAs: [GITHUB_REPOSITORY_URL],
+ parentOrganization: publisherJsonLd,
+ } as const;
+}
+
export function websiteJsonLd() {
return {
"@context": "https://schema.org",
diff --git a/app/site-copy.ts b/app/site-copy.ts
new file mode 100644
index 0000000..e861ba5
--- /dev/null
+++ b/app/site-copy.ts
@@ -0,0 +1,88 @@
+import { GITHUB_REPOSITORY_URL, HRANESS_URL, SITE_ORIGIN, site } from "./site";
+
+export const notFoundTitle = "Page not found";
+export const notFoundDescription = "The requested Stripe history page does not exist.";
+
+export const aboutTitle = "About";
+export const aboutSocialTitle = `About ${site.domain}`;
+export const aboutDescription =
+ `How ${site.domain} selects, summarizes, sources, reviews, corrects, and measures its independent Stripe company history.`;
+
+export const privacyTitle = "Privacy";
+export const privacySocialTitle = `Privacy | ${site.domain}`;
+export const privacyDescription =
+ `How ${site.domain} handles analytics, cookies, accounts, and hosting logs for the independent Stripe company history.`;
+
+export const contactTitle = "Contact";
+export const contactSocialTitle = `Contact ${site.domain}`;
+export const contactDescription =
+ `How to send a correction, source, or security report for the independent Stripe company history at ${site.domain}.`;
+
+export const paymentVolumeTitle = "Stripe Payment and Total Volume by Year";
+export const paymentVolumeDescription =
+ "Stripe annual volume history: payment volume from 2021 through 2024 and total volume for 2025, with source-linked disclosures from $640 billion+ to $1.9 trillion.";
+
+export const dataTitle = "Stripe Company History Dataset";
+
+export const independenceSentence =
+ `${site.domain} is not affiliated with, endorsed by, or operated by Stripe, Inc. Stripe names and trademarks belong to their respective owners.`;
+
+export const recoveryLinks = [
+ { href: `${SITE_ORIGIN}/`, label: "Stripe company history" },
+ { href: `${SITE_ORIGIN}/llms.txt`, label: "Agent index (llms.txt)" },
+ { href: `${SITE_ORIGIN}/sitemap.xml`, label: "Sitemap" },
+ { href: `${SITE_ORIGIN}/about`, label: "About" },
+ { href: `${SITE_ORIGIN}/data`, label: "Open history and research data" },
+ { href: `${SITE_ORIGIN}/contact`, label: "Contact" },
+ { href: `${SITE_ORIGIN}/privacy`, label: "Privacy" },
+] as const;
+
+export const aboutSections = [
+ {
+ heading: "Stripe company history",
+ paragraphs: [
+ `${site.domain} is an independent, sourced guide to Stripe. It publishes a reverse-chronological company timeline covering acquisitions, products, leadership, funding, valuation, expansion, offices, publishing projects, founder side projects and aesthetics programs, early history, annual volume, and reviewed long-form appearances by Stripe founders and senior leaders.`,
+ ],
+ },
+ {
+ heading: "Sources and review",
+ paragraphs: [
+ "History entries link to primary sources or strong contemporaneous reporting. Editorial review checks chronology, source support, category placement, and duplicate claims, and preserves uncertainty when a transaction or event was only proposed or reported.",
+ ],
+ },
+ {
+ heading: "Independence and corrections",
+ paragraphs: [
+ `${independenceSentence} Corrections are made in the underlying sourced records so the timeline and its focused category views stay aligned.`,
+ ],
+ },
+ {
+ heading: "Publisher and contributions",
+ paragraphs: [
+ `Published and maintained by [Hraness](${HRANESS_URL}). To suggest a correction, add a source, or improve the project, open an issue or contribution in the [Stripedex repository](${GITHUB_REPOSITORY_URL}). Use the [contact page](${SITE_ORIGIN}/contact) for the same public channels.`,
+ ],
+ },
+] as const;
+
+export const privacyParagraphs = [
+ `The site sends anonymous, cookieless pageview events for public pages to PostHog. Each event contains the normalized public page path, its page category, a site identifier, an analytics schema version, and PostHog's cookieless marker. It excludes query strings, URL fragments, referrer properties, account data, and user content. The browser does not save an analytics cookie or identifier.`,
+ `The site does not use autocapture, session replay, heatmaps, surveys, feature flags, performance monitoring, or user profiles, and it has no user accounts or authentication. Requests are still subject to the ordinary logs and security controls of the hosting provider.`,
+ `${site.domain} does not sell personal data, does not run advertising pixels, and does not keep a reader profile. Appearance preferences stay in the browser. Machine-readable copies of the public pages are available as Markdown when a client sends \`Accept: text/markdown\`, and the authored YAML records remain downloadable from the [dataset index](${SITE_ORIGIN}/data).`,
+ `Questions about this policy belong on the [contact page](${SITE_ORIGIN}/contact) or in the [Stripedex repository](${GITHUB_REPOSITORY_URL}). The broader sourcing and independence statement lives on the [about page](${SITE_ORIGIN}/about).`,
+] as const;
+
+export const contactParagraphs = [
+ `Use public GitHub issues for ordinary historical corrections, missing events, stronger sources, and focused software improvements. Include the event date, a concise factual claim, its category, the proposed confidence and status, and at least one source URL. Prefer primary sources. If a claim was only proposed or reported, keep that uncertainty in the record.`,
+ `Report suspected vulnerabilities through GitHub's private vulnerability reporting for this repository. Do not include sensitive details in a public issue.`,
+ `There is no reader account, contact form, or product inbox on ${site.domain}. The project does not process payments, issue API keys, or operate a Stripe integration. ${independenceSentence}`,
+ `Published and maintained by [Hraness](${HRANESS_URL}). The complete sourced records and website code are in the [Stripedex repository](${GITHUB_REPOSITORY_URL}). Read [about](${SITE_ORIGIN}/about) for editorial method and [privacy](${SITE_ORIGIN}/privacy) for analytics limits.`,
+] as const;
+
+export const paymentVolumeIntro =
+ "Stripe reported annual payment volume from 2021 through 2024 and switched to “total volume” for its 2025 figure.";
+
+export const paymentVolumeMethod =
+ "Years refer to the calendar year measured, not the later disclosure date. Values preserve Stripe’s published wording and qualifiers. The 2021 and 2022 figures are lower bounds, and Stripe calls the 2025 figure “total volume.” Missing years are not inferred from rounded growth rates.";
+
+export const dataIntro =
+ "These reviewable YAML files power the public timeline and valuation record. History entries preserve chronology, category, summary, confidence, and status when applicable; the research files preserve canonical source identities, valuation observations, leadership appearances, collection scope, and review runs.";
diff --git a/app/site-footer.tsx b/app/site-footer.tsx
index 6cfe977..c181f85 100644
--- a/app/site-footer.tsx
+++ b/app/site-footer.tsx
@@ -9,6 +9,8 @@ export function SiteFooter() {