hello standard.site (#436)

Author: TkDodo

.gitignore

@@ -2,6 +2,9 @@ blog-main
 
 # build output
 dist/
+.sequoia/
+.sequoia-state.json
+.tmp-standard-site-*/
 
 # generated types
 .astro/

knip.json

@@ -19,6 +19,7 @@
     "@tailwindcss/typography",
     "shiki",
     "tailwindcss",
+    "sequoia-cli",
     "@tanstack/react-router",
     "arktype"
   ]

netlify.toml

@@ -1,3 +1,7 @@
+[build]
+command = "pnpm run build:netlify"
+publish = "dist"
+
 [[redirects]]
 from = "/"
 to = "/blog"

package.json

@@ -7,6 +7,7 @@
     "dev": "astro dev",
     "build:astro": "astro build",
     "build": "pnpm run build:astro",
+    "build:netlify": "node --import tsx ./scripts/netlify-build.ts",
     "preview": "astro preview",
     "typecheck": "astro check",
     "astro": "astro",
@@ -17,7 +18,10 @@
     "test": "vitest run",
     "format:check": "oxfmt --check . && prettier --check \"src/**/*.astro\"",
     "format:write": "oxfmt . && prettier --write \"src/**/*.astro\"",
-    "ogimages": "tsx ./scripts/og-image.tsx"
+    "ogimages": "tsx ./scripts/og-image.tsx",
+    "standard-site:content": "node --import tsx ./scripts/standard-site-content.ts",
+    "standard-site:details": "node --import tsx ./scripts/standard-site-content.ts --details",
+    "standard-site:update-publication": "node --import tsx ./scripts/update-standard-site-publication.ts"
   },
   "dependencies": {
     "@atcute/bluesky-richtext-segmenter": "^3.0.0",
@@ -50,8 +54,8 @@
     "@astrojs/rss": "^4.0.17",
     "@astrojs/sitemap": "^3.7.1",
     "@tailwindcss/typography": "^0.5.19",
-    "@tanstack/react-router": "^1.170.8",
     "@tanstack/react-query": "^5.90.21",
+    "@tanstack/react-router": "^1.170.8",
     "@types/mdast": "^4.0.4",
     "@types/react": "^19.2.2",
     "@types/react-dom": "^19.2.2",
@@ -72,6 +76,7 @@
     "rehype-external-links": "^3.0.0",
     "remark-directive": "^4.0.0",
     "remark-smartypants": "^3.0.2",
+    "sequoia-cli": "^0.5.6",
     "sharp": "^0.34.4",
     "shiki": "^3.22.0",
     "sirv": "^3.0.2",

pnpm-lock.yaml

@@ -0,0 +1 @@
+at://did:plc:3nqrhu5mthmias3zc4a2ovzj/site.standard.publication/3mmyb25hudm2r

public/.well-known/.gitkeep

@@ -0,0 +1,26 @@
+import { spawnSync } from "node:child_process";
+
+function run(command: string, args: Array<string>) {
+  const result = spawnSync(command, args, {
+    stdio: "inherit",
+    shell: false,
+  });
+
+  if (result.status !== 0) {
+    process.exit(result.status ?? 1);
+  }
+}
+
+run("pnpm", ["run", "build:astro"]);
+
+if (process.env.CONTEXT !== "production") {
+  console.log(
+    `Skipping standard.site publish for Netlify context: ${process.env.CONTEXT ?? "unknown"}`,
+  );
+  process.exit(0);
+}
+
+run("pnpm", ["run", "standard-site:content"]);
+run("pnpm", ["exec", "sequoia", "sync", "--update-frontmatter"]);
+run("pnpm", ["exec", "sequoia", "publish"]);
+run("pnpm", ["exec", "sequoia", "inject", "--output", "./dist"]);

public/.well-known/site.standard.publication

@@ -0,0 +1,33 @@
+import fs from "node:fs";
+import { describe, expect, it } from "vitest";
+
+describe("standard.site configuration", () => {
+  it("publishes generated rendered content through Sequoia", () => {
+    const config = JSON.parse(fs.readFileSync("sequoia.json", "utf-8"));
+
+    expect(config.siteUrl).toBe("https://tkdodo.eu");
+    expect(config.contentDir).toBe("./.sequoia/generated/posts");
+    expect(config.outputDir).toBe("./dist");
+    expect(config.pathPrefix).toBe("/blog");
+    expect(config.removeIndexFromSlug).toBe(true);
+    expect(config.frontmatter.publishDate).toBe("date");
+    expect(config.frontmatter.slugField).toBe("slug");
+    expect(config.frontmatter.coverImage).toBe("ogImage");
+    expect(config.textContentField).toBeUndefined();
+    expect(config.publishContent).toBe(false);
+    expect(config.bluesky).toMatchObject({ maxAgeDays: 7 });
+    expect(typeof config.bluesky.enabled).toBe("boolean");
+  });
+
+  it("keeps well-known publication verification in sync", () => {
+    const config = JSON.parse(fs.readFileSync("sequoia.json", "utf-8"));
+    const verification = fs
+      .readFileSync("public/.well-known/site.standard.publication", "utf-8")
+      .trim();
+
+    expect(verification).toBe(config.publicationUri);
+    expect(verification).toMatch(
+      /^at:\/\/did:plc:3nqrhu5mthmias3zc4a2ovzj\/site\.standard\.publication\//,
+    );
+  });
+});

scripts/netlify-build.ts

@@ -0,0 +1,95 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { afterEach, describe, expect, it } from "vitest";
+import {
+  generateStandardSiteContent,
+  getStandardSiteSlug,
+} from "./standard-site-content";
+
+const tmpDirs: Array<string> = [];
+
+afterEach(async () => {
+  await Promise.all(
+    tmpDirs
+      .splice(0)
+      .map((dir) => fs.rm(dir, { recursive: true, force: true })),
+  );
+});
+
+async function createTmpDir() {
+  const dir = await fs.mkdtemp(path.join(process.cwd(), ".tmp-standard-site-"));
+  tmpDirs.push(dir);
+  return dir;
+}
+
+describe("getStandardSiteSlug", () => {
+  it("prefers explicit frontmatter slugs", () => {
+    expect(
+      getStandardSiteSlug("content/posts/folder/index.mdx", "custom"),
+    ).toBe("custom");
+  });
+
+  it("falls back to the parent folder for index.mdx posts", () => {
+    expect(getStandardSiteSlug("content/posts/my-post/index.mdx")).toBe(
+      "my-post",
+    );
+  });
+});
+
+describe("generateStandardSiteContent", () => {
+  it("writes generated MDX with metadata-only standard.site frontmatter", async () => {
+    const rootDir = await createTmpDir();
+    const contentDir = path.join(rootDir, "content/posts");
+    const outputDir = path.join(rootDir, ".sequoia/generated/posts");
+
+    await fs.mkdir(path.join(contentDir, "my-post"), { recursive: true });
+    await fs.writeFile(
+      path.join(contentDir, "my-post/index.mdx"),
+      `---
+title: My Post
+description: A useful post
+date: 2026-05-29
+slug: my-custom-post
+tags:
+  - React
+  - TypeScript
+---
+
+import Aside from '@components/Aside'
+
+<Aside>Implementation detail</Aside>
+
+Article source
+`,
+    );
+
+    const result = await generateStandardSiteContent({
+      contentDir,
+      outputDir,
+    });
+
+    expect(result).toEqual([
+      {
+        canonicalPath: "/blog/my-custom-post",
+        coverImage: "my-custom-post.png",
+        slug: "my-custom-post",
+        title: "My Post",
+      },
+    ]);
+
+    const generated = await fs.readFile(
+      path.join(outputDir, "my-custom-post/index.mdx"),
+      "utf-8",
+    );
+
+    expect(generated).toContain("title: My Post");
+    expect(generated).toContain("description: A useful post");
+    expect(generated).toContain("date: 2026-05-29");
+    expect(generated).toContain("ogImage: my-custom-post.png");
+    expect(generated).toContain("slug: my-custom-post");
+    expect(generated).toContain("- React");
+    expect(generated).toContain(
+      "Source metadata is generated for standard.site publishing.",
+    );
+  });
+});