marketing: add crawl and entity signals for t3.codes

apps/marketing/astro.config.mjs

@@ -8,6 +8,8 @@ delete process.env.VP_RUN_NODE_CLIENT_PATH;
 
 export default defineConfig({
   site: "https://t3.codes",
+  // Vercel 308s `/path/` to `/path` (see vercel.ts), so every internal link and canonical uses one form.
+  trailingSlash: "never",
   server: {
     port: Number(process.env.PORT ?? 4173),
   },

apps/marketing/public/.well-known/security.txt

@@ -0,0 +1,5 @@
+Contact: mailto:security@t3.codes
+Policy: https://t3.codes/security-policy
+Canonical: https://t3.codes/.well-known/security.txt
+Preferred-Languages: en
+Expires: 2027-11-01T00:00:00.000Z

apps/marketing/src/layouts/Layout.astro

@@ -9,18 +9,27 @@ import {
   IOS_APP_STORE_URL,
   MARKETING_STATS,
 } from "../lib/site";
+import { type JsonLd, jsonLdGraph, organizationJsonLd, websiteJsonLd } from "../lib/seo";
 
 interface Props {
   title?: string;
   description?: string;
   pageClass?: string;
+  /** Page-specific schema.org nodes. Organization and WebSite are always included. */
+  jsonLd?: ReadonlyArray<JsonLd>;
+  ogType?: "website" | "article";
+  noindex?: boolean;
 }
 
 const {
   title = "T3 Code",
   description = "T3 Code. The open-source control plane for coding agents.",
   pageClass,
+  jsonLd = [],
+  ogType = "website",
+  noindex = false,
 } = Astro.props;
+const structuredData = jsonLdGraph([organizationJsonLd(), websiteJsonLd(), ...jsonLd]);
 
 // Link unfurlers require a 1200x630 JPG/PNG at an absolute URL.
 const socialImage = await getImage({
@@ -41,8 +50,8 @@ const canonicalUrl = new URL(Astro.url.pathname, Astro.site);
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <meta name="description" content={description} />
-    <link rel="canonical" href={canonicalUrl} />
-    <meta property="og:type" content="website" />
+    {noindex ? <meta name="robots" content="noindex" /> : <link rel="canonical" href={canonicalUrl} />}
+    <meta property="og:type" content={ogType} />
     <meta property="og:site_name" content="T3 Code" />
     <meta property="og:url" content={canonicalUrl} />
     <meta property="og:title" content={title} />
@@ -61,7 +70,10 @@ const canonicalUrl = new URL(Astro.url.pathname, Astro.site);
     <link rel="icon" type="image/png" href="/favicon-32x32.png" sizes="32x32" />
     <link rel="icon" type="image/png" href="/favicon-16x16.png" sizes="16x16" />
     <link rel="apple-touch-icon" href="/apple-touch-icon.png" />
+    <link rel="sitemap" type="application/xml" href="/sitemap.xml" />
     <title>{title}</title>
+    <script type="application/ld+json" set:html={structuredData} />
+    <slot name="head" />
   </head>
   <body>
     <div class:list={["page", pageClass]}>

apps/marketing/src/lib/seo.ts

@@ -0,0 +1,80 @@
+import { ANDROID_PLAY_STORE_URL, GITHUB_REPOSITORY_URL, IOS_APP_STORE_URL } from "./site";
+
+export const SITE_ORIGIN = "https://t3.codes";
+export const SITE_NAME = "T3 Code";
+export const SITE_TAGLINE = "The open-source control plane for coding agents";
+
+// The canonical set of official properties. Search engines and AI answer engines read `sameAs`
+// to tie an entity to its real homes, which is the signal a look-alike domain cannot copy.
+export const OFFICIAL_PROFILES = [
+  GITHUB_REPOSITORY_URL,
+  IOS_APP_STORE_URL,
+  ANDROID_PLAY_STORE_URL,
+  "https://discord.gg/jn4EGJjrvv",
+] as const;
+
+export type JsonLd = Record<string, unknown>;
+
+const ORGANIZATION_ID = `${SITE_ORIGIN}/#organization`;
+const WEBSITE_ID = `${SITE_ORIGIN}/#website`;
+const SOFTWARE_ID = `${SITE_ORIGIN}/#software`;
+
+export const absoluteUrl = (pathname: string): string => new URL(pathname, SITE_ORIGIN).href;
+
+export const organizationJsonLd = (): JsonLd => ({
+  "@type": "Organization",
+  "@id": ORGANIZATION_ID,
+  name: "T3 Tools Inc",
+  url: SITE_ORIGIN,
+  logo: absoluteUrl("/apple-touch-icon.png"),
+  sameAs: ["https://github.com/pingdotgg"],
+});
+
+export const websiteJsonLd = (): JsonLd => ({
+  "@type": "WebSite",
+  "@id": WEBSITE_ID,
+  name: SITE_NAME,
+  url: SITE_ORIGIN,
+  publisher: { "@id": ORGANIZATION_ID },
+});
+
+export const softwareJsonLd = (): JsonLd => ({
+  "@type": "SoftwareApplication",
+  "@id": SOFTWARE_ID,
+  name: SITE_NAME,
+  description: `${SITE_NAME}. ${SITE_TAGLINE}.`,
+  url: SITE_ORIGIN,
+  downloadUrl: absoluteUrl("/download"),
+  applicationCategory: "DeveloperApplication",
+  operatingSystem: "macOS, Windows, Linux, iOS, Android",
+  license: "https://opensource.org/license/mit",
+  isAccessibleForFree: true,
+  offers: { "@type": "Offer", price: "0", priceCurrency: "USD" },
+  codeRepository: GITHUB_REPOSITORY_URL,
+  publisher: { "@id": ORGANIZATION_ID },
+  sameAs: [...OFFICIAL_PROFILES],
+});
+
+export const breadcrumbJsonLd = (items: ReadonlyArray<{ name: string; path: string }>): JsonLd => ({
+  "@type": "BreadcrumbList",
+  itemListElement: items.map((item, index) => ({
+    "@type": "ListItem",
+    position: index + 1,
+    name: item.name,
+    item: absoluteUrl(item.path),
+  })),
+});
+
+export const jsonLdGraph = (nodes: ReadonlyArray<JsonLd>): string =>
+  // `<` is escaped so page text inside the graph can never close the script tag.
+  JSON.stringify({ "@context": "https://schema.org", "@graph": nodes }).replace(/</g, "\\u003c");
+
+// Indexable static pages. The 404 (noindex) and the /95 easter egg stay out of the sitemap.
+export const STATIC_PAGES = [
+  { path: "/", priority: "1.0" },
+  { path: "/download", priority: "0.9" },
+  { path: "/legal", priority: "0.3" },
+  { path: "/privacy-policy", priority: "0.3" },
+  { path: "/security-policy", priority: "0.3" },
+  { path: "/terms-of-service", priority: "0.3" },
+] as const;

apps/marketing/src/pages/404.astro

@@ -0,0 +1,44 @@
+---
+import Layout from "../layouts/Layout.astro";
+---
+
+<Layout title="Page not found | T3 Code" description="This page does not exist on t3.codes." noindex>
+  <section class="not-found container">
+    <p class="eyebrow">404</p>
+    <h1 class="display">This page does not exist.</h1>
+    <p class="not-found-lede">
+      t3.codes is the only official T3 Code website. Download builds from this site, GitHub releases,
+      or the app stores.
+    </p>
+    <div class="not-found-actions">
+      <a class="btn btn-primary btn-lg" href="/download">Download T3 Code</a>
+      <a class="btn btn-ghost btn-lg" href="/">Home</a>
+    </div>
+  </section>
+</Layout>
+
+<style>
+  .not-found {
+    padding-top: 18vh;
+    padding-bottom: 18vh;
+    max-width: 720px;
+  }
+
+  .not-found h1 {
+    margin: 14px 0 18px;
+    font-size: clamp(2.25rem, 5vw, 3.5rem);
+  }
+
+  .not-found-lede {
+    color: var(--fg-muted);
+    font-size: 1.05rem;
+    line-height: 1.7;
+  }
+
+  .not-found-actions {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 12px;
+    margin-top: 32px;
+  }
+</style>

apps/marketing/src/pages/download.astro

@@ -6,6 +6,7 @@ import iconNightly from "../assets/icon-nightly.webp";
 import Layout from "../layouts/Layout.astro";
 import { RELEASES_URL } from "../lib/releases";
 import { ANDROID_PLAY_STORE_URL, IOS_APP_STORE_URL } from "../lib/site";
+import { breadcrumbJsonLd, softwareJsonLd } from "../lib/seo";
 
 const imageProps = {
   alt: "",
@@ -16,7 +17,17 @@ const imageProps = {
 } satisfies Partial<ComponentProps<typeof Image>>;
 ---
 
-<Layout title="Download | T3 Code" description="Download T3 Code for macOS, Windows, or Linux.">
+<Layout
+  title="Download T3 Code for macOS, Windows, and Linux | T3 Code"
+  description="Download the official T3 Code desktop app for macOS, Windows, or Linux, or get the iOS and Android apps. t3.codes is the only official download site."
+  jsonLd={[
+    softwareJsonLd(),
+    breadcrumbJsonLd([
+      { name: "T3 Code", path: "/" },
+      { name: "Download", path: "/download" },
+    ]),
+  ]}
+>
   <div class="download-page" id="download-page" data-channel="stable">
     <header class="download-head">
       <div class="sky" aria-hidden="true"></div>

apps/marketing/src/pages/index.astro

@@ -9,6 +9,7 @@ import {
   MARKETING_STATS,
 } from "../lib/site";
 import { tweets } from "../lib/tweets";
+import { softwareJsonLd } from "../lib/seo";
 
 const screenshot = await getImage({
   src: desktopScreenshot,
@@ -29,7 +30,10 @@ const mobileEndorsementRows = [
 ];
 ---
 
-<Layout>
+<Layout
+  title="T3 Code | The open-source control plane for coding agents"
+  jsonLd={[softwareJsonLd()]}
+>
   <section class="hero">
     <div class="hero-grid" aria-hidden="true"></div>
 

apps/marketing/src/pages/llms.txt.ts

@@ -0,0 +1,30 @@
+import type { APIRoute } from "astro";
+
+import { ANDROID_PLAY_STORE_URL, GITHUB_REPOSITORY_URL, IOS_APP_STORE_URL } from "../lib/site";
+import { absoluteUrl, SITE_TAGLINE } from "../lib/seo";
+
+// https://llmstxt.org: a plain index that tells AI agents which domain and links are official.
+export const GET: APIRoute = () => {
+  const body = `# T3 Code
+
+> ${SITE_TAGLINE}. T3 Code is free, MIT-licensed, and built by T3 Tools Inc. It runs Claude Code, Codex, Cursor, OpenCode, Grok, Antigravity, and other coding agents from one desktop, web, and mobile app.
+
+The only official website is https://t3.codes. Official builds come from ${absoluteUrl("/download")}, ${GITHUB_REPOSITORY_URL}/releases, the \`t3\` package on npm (\`npx t3@latest\`), the iOS App Store, and Google Play. Any other website that offers a T3 Code download is not affiliated with T3 Tools Inc.
+
+## Official links
+
+- [Download T3 Code](${absoluteUrl("/download")}): macOS, Windows, and Linux installers
+- [Source code](${GITHUB_REPOSITORY_URL}): the MIT-licensed repository
+- [Releases](${GITHUB_REPOSITORY_URL}/releases): release builds and changelogs
+- [npm package](https://www.npmjs.com/package/t3): run \`npx t3@latest\`
+- [iOS app](${IOS_APP_STORE_URL})
+- [Android app](${ANDROID_PLAY_STORE_URL})
+
+## Policies
+
+- [Security policy](${absoluteUrl("/security-policy")})
+- [Privacy policy](${absoluteUrl("/privacy-policy")})
+- [Terms of service](${absoluteUrl("/terms-of-service")})
+`;
+  return new Response(body, { headers: { "Content-Type": "text/plain; charset=utf-8" } });
+};

apps/marketing/src/pages/robots.txt.ts

@@ -0,0 +1,29 @@
+import type { APIRoute } from "astro";
+
+import { absoluteUrl } from "../lib/seo";
+
+// Answer engines (ChatGPT search, Claude, Perplexity) cite what their crawlers can fetch.
+// Naming them keeps a future blanket rule from silently locking out the official site.
+const ANSWER_ENGINE_AGENTS = [
+  "OAI-SearchBot",
+  "ChatGPT-User",
+  "GPTBot",
+  "Claude-SearchBot",
+  "Claude-User",
+  "ClaudeBot",
+  "PerplexityBot",
+  "Bingbot",
+  "Googlebot",
+];
+
+export const GET: APIRoute = () => {
+  const body = [
+    ...ANSWER_ENGINE_AGENTS.flatMap((agent) => [`User-agent: ${agent}`, "Allow: /", ""]),
+    "User-agent: *",
+    "Allow: /",
+    "",
+    `Sitemap: ${absoluteUrl("/sitemap.xml")}`,
+    "",
+  ].join("\n");
+  return new Response(body, { headers: { "Content-Type": "text/plain; charset=utf-8" } });
+};

apps/marketing/src/pages/security-policy.astro

@@ -46,7 +46,7 @@ const sections = [
     <h2>Reporting Security Issues</h2>
     <p>
       If you believe you have found a security vulnerability affecting T3 Code or T3 Tools-operated
-      infrastructure, email{" "}<a href="mailto:security@ping.gg">security@ping.gg</a>. Please do not
+      infrastructure, email{" "}<a href="mailto:security@t3.codes">security@t3.codes</a>. Please do not
       disclose the issue publicly until we have had a reasonable opportunity to investigate and
       remediate it.
     </p>
@@ -176,7 +176,7 @@ const sections = [
     <h2>Contact Us</h2>
     <p>
       Report security issues or ask security-related questions at{" "}<a
-        href="mailto:security@ping.gg">security@ping.gg</a
+        href="mailto:security@t3.codes">security@t3.codes</a
       >.
     </p>
     <p>

apps/marketing/src/pages/sitemap.xml.ts

@@ -0,0 +1,16 @@
+import type { APIRoute } from "astro";
+
+import { absoluteUrl, STATIC_PAGES } from "../lib/seo";
+
+export const GET: APIRoute = () => {
+  const urls = STATIC_PAGES.map(
+    (page) =>
+      `  <url><loc>${absoluteUrl(page.path)}</loc><priority>${page.priority}</priority></url>`,
+  );
+  const body = `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${urls.join("\n")}
+</urlset>
+`;
+  return new Response(body, { headers: { "Content-Type": "application/xml; charset=utf-8" } });
+};

apps/marketing/vercel.ts

@@ -7,6 +7,8 @@ export const config: VercelConfig = {
   installCommand: "npm install -g vite-plus && vp install --filter '@t3tools/marketing...'",
   buildCommand: "vp run --filter @t3tools/marketing build",
   outputDirectory: "dist",
+  // One URL per page: `/download/` and `/download` both served 200 before, which splits ranking signals.
+  trailingSlash: false,
   // curl | sh requires plain, uncompressed scripts with no cache across deploys.
   headers: [
     {