reallysimpledocs 0.1.3

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Ronan Berder
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,84 @@
+# ReallySimpleDocs
+
+A simple documentation system for Astro, built with **Basecoat** and **Tailwind CSS**.
+
+RSD keeps docs portable: content lives in `docs/`, navigation lives in `docs/docs.json`, and the Astro integration owns the docs UI.
+
+## Add to an Astro site
+
+```bash
+npm install reallysimpledocs@beta basecoat-css@beta
+```
+
+Add the integration:
+
+```js
+// astro.config.mjs
+import { defineConfig } from "astro/config";
+import reallySimpleDocs from "reallysimpledocs/astro";
+
+export default defineConfig({
+  integrations: [
+    reallySimpleDocs({
+      docsDir: "./docs",
+      routeBase: "/docs",
+      style: "vega",
+      customCss: ["./src/docs.css"],
+      site: {
+        title: "ReallySimpleDocs",
+        description: "A simple documentation system for Astro.",
+      },
+    }),
+  ],
+});
+```
+
+Create docs:
+
+```text
+docs/
+├── docs.json
+└── index.md
+```
+
+```json
+{
+  "menu": [
+    {
+      "type": "group",
+      "label": "Docs",
+      "items": [{ "slug": "index", "icon": "info" }]
+    }
+  ]
+}
+```
+
+```md
+# Introduction
+
+Welcome to the docs.
+```
+
+RSD injects docs pages, Lunr search, per-page Markdown exports, `llms.txt`, and `llms-full.txt`.
+
+## Local development (this repo)
+
+```bash
+npm install
+npm run dev
+```
+
+## Documentation
+
+Go to [ReallySimpleDocs.com](https://reallysimpledocs.com).
+
+## Support the project 
+
+- [Contribute code](/CONTRIBUTING.md)
+- [Report issues](https://github.com/hunvreus/reallysimpledocs/issues)
+- [Sponsor me](https://github.com/sponsors/hunvreus)
+- [Star the project on GitHub](https://github.com/hunvreus/reallysimpledocs)
+
+## License
+
+[MIT](/LICENSE.md)

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "reallysimpledocs",
+  "version": "0.1.3",
+  "type": "module",
+  "exports": {
+    ".": "./src/index.js",
+    "./astro": "./src/astro/index.js",
+    "./components": "./src/components/index.js"
+  },
+  "files": [
+    "src",
+    "README.md",
+    "LICENSE.md"
+  ],
+  "scripts": {
+    "dev": "astro dev",
+    "build": "rm -rf dist && astro build",
+    "preview": "astro preview",
+    "smoke:consumer": "node scripts/smoke-consumer.mjs",
+    "check": "npm run build && npm pack --dry-run && npm run smoke:consumer"
+  },
+  "dependencies": {
+    "@tailwindcss/vite": "4.1.17",
+    "astro": "^6.4.6",
+    "github-slugger": "^2.0.0",
+    "lucide-static": "^0.552.0",
+    "lunr": "^2.3.9",
+    "marked": "^16.4.1",
+    "shiki": "^4.1.0",
+    "tailwindcss": "4.1.17"
+  },
+  "peerDependencies": {
+    "basecoat-css": "^1.0.0-beta.1"
+  },
+  "devDependencies": {
+    "basecoat-css": "^1.0.0-beta.1"
+  },
+  "overrides": {
+    "esbuild": "^0.28.1",
+    "picomatch": "^4.0.4"
+  }
+}

package/src/astro/index.js

@@ -0,0 +1,131 @@
+import { fileURLToPath } from "node:url";
+import fs from "node:fs";
+import path from "node:path";
+import tailwindcss from "@tailwindcss/vite";
+
+const basecoatStyles = new Set(["vega", "nova", "maia", "lyra", "mira", "luma", "sera", "rhea"]);
+
+const normalizeRouteBase = (routeBase) => {
+  const value = String(routeBase || "/").trim();
+  if (!value || value === "/") return "";
+  return value.replace(/^\/+|\/+$/g, "");
+};
+
+const routePattern = (routeBase, suffix = "[...slug]") => {
+  const base = normalizeRouteBase(routeBase);
+  return base ? `${base}/${suffix}` : suffix;
+};
+
+const runtimePath = (relativePath) =>
+  fileURLToPath(new URL(`../runtime/${relativePath}`, import.meta.url));
+
+const cssPath = (relativePath) => fileURLToPath(new URL(`../css/${relativePath}`, import.meta.url));
+
+const normalizeArray = (value) => (Array.isArray(value) ? value : value ? [value] : []);
+
+export default function reallySimpleDocs(options = {}) {
+  const style = options.style || "vega";
+  if (!basecoatStyles.has(style)) {
+    throw new Error(`Invalid ReallySimpleDocs style "${style}". Expected one of: ${Array.from(basecoatStyles).join(", ")}.`);
+  }
+
+  const normalizedOptions = {
+    docsDir: options.docsDir || "./docs",
+    site: options.site || {},
+    siteFile: options.siteFile || null,
+    style,
+    customCss: normalizeArray(options.customCss),
+    components: options.components || {},
+    routeBase: options.routeBase ?? "/docs",
+    assetsBase: options.assetsBase || "/assets",
+  };
+
+  return {
+    name: "reallysimpledocs",
+    hooks: {
+      "astro:config:setup": ({ injectRoute, updateConfig, config }) => {
+        const root = fileURLToPath(config.root);
+        const generatedDir = path.join(root, ".astro", "reallysimpledocs");
+        const generatedStyles = path.join(generatedDir, "styles.css");
+        const virtualConfig = {
+          ...normalizedOptions,
+          root,
+          docsDir: path.resolve(root, normalizedOptions.docsDir),
+          siteFile: normalizedOptions.siteFile ? path.resolve(root, normalizedOptions.siteFile) : null,
+          routeBase: normalizeRouteBase(normalizedOptions.routeBase),
+        };
+        const resolveUserId = (id) => (id?.startsWith(".") ? path.resolve(root, id) : id);
+        const components = {
+          SidebarHeader:
+            normalizedOptions.components.SidebarHeader || runtimePath("components/DefaultSidebarHeader.astro"),
+        };
+        fs.mkdirSync(generatedDir, { recursive: true });
+        fs.writeFileSync(
+          generatedStyles,
+          [
+            '@import "tailwindcss";',
+            '@import "basecoat-css/base";',
+            `@import "basecoat-css/styles/${style}";`,
+            `@import ${JSON.stringify(cssPath("sources.css"))};`,
+            `@import ${JSON.stringify(cssPath("custom.css"))};`,
+            `@import ${JSON.stringify(cssPath("overrides.css"))};`,
+            ...normalizedOptions.customCss.map((css) => `@import ${JSON.stringify(resolveUserId(css))};`),
+            `@source ${JSON.stringify(runtimePath("**/*.{astro,js,ts}"))};`,
+            `@source ${JSON.stringify(path.join(virtualConfig.docsDir, "**/*.md"))};`,
+            "",
+          ].join("\n"),
+        );
+
+        injectRoute({
+          pattern: routePattern(normalizedOptions.routeBase),
+          entrypoint: runtimePath("pages/doc.astro"),
+        });
+        injectRoute({
+          pattern: routePattern(normalizedOptions.routeBase, "[...slug].md"),
+          entrypoint: runtimePath("pages/markdown.ts"),
+        });
+        injectRoute({
+          pattern: routePattern(normalizedOptions.routeBase, "search-index.json"),
+          entrypoint: runtimePath("pages/search-index.ts"),
+        });
+        injectRoute({
+          pattern: "llms.txt",
+          entrypoint: runtimePath("pages/llms.txt.ts"),
+        });
+        injectRoute({
+          pattern: "llms-full.txt",
+          entrypoint: runtimePath("pages/llms-full.txt.ts"),
+        });
+
+        updateConfig({
+          vite: {
+            build: {
+              cssMinify: false,
+            },
+            plugins: [
+              tailwindcss(),
+              {
+                name: "reallysimpledocs-virtual-modules",
+                resolveId(id) {
+                  if (id === "virtual:reallysimpledocs/config") return "\0virtual:reallysimpledocs/config";
+                  if (id === "virtual:reallysimpledocs/styles.css") return generatedStyles;
+                  if (id === "virtual:reallysimpledocs/components/SidebarHeader") {
+                    return "\0virtual:reallysimpledocs/components/SidebarHeader";
+                  }
+                  return null;
+                },
+                load(id) {
+                  if (id === "\0virtual:reallysimpledocs/config") return `export default ${JSON.stringify(virtualConfig)};`;
+                  if (id === "\0virtual:reallysimpledocs/components/SidebarHeader") {
+                    return `export { default } from ${JSON.stringify(resolveUserId(components.SidebarHeader))};`;
+                  }
+                  return null;
+                },
+              },
+            ],
+          },
+        });
+      },
+    },
+  };
+}

package/src/components/index.js

@@ -0,0 +1,4 @@
+export { default as DocsLayout } from "../runtime/components/DocsLayout.astro";
+export { default as CommandDialog } from "../runtime/components/CommandDialog.astro";
+export { default as DropdownMenu } from "../runtime/components/DropdownMenu.astro";
+export { default as Sidebar } from "../runtime/components/Sidebar.astro";

package/src/css/custom.css

@@ -0,0 +1,157 @@
+@theme {
+  --color-search-highlight: oklch(90.5% 0.182 98.111);
+}
+
+.prose {
+  @apply my-6;
+
+  > h2,
+  > h3,
+  > h4 {
+    @apply sm:text-lg my-6 scroll-m-18 font-semibold tracking-tight;
+
+    a {
+      @apply no-underline;
+    }
+  }
+  > h2 {
+    @apply text-xl sm:text-2xl mt-8 lg:mt-12 first:mt-0;
+  }
+  > h3 {
+    @apply text-lg sm:text-xl lg:mt-8;
+  }
+  p > a,
+  li > a,
+  dt > a,
+  dd > a,
+  td > a,
+  th > a {
+    @apply underline underline-offset-2 decoration-muted-foreground/50 hover:decoration-foreground/50 transition-all;
+  }
+  code:not(pre > code) {
+    @apply relative rounded-md bg-muted px-[0.3rem] py-[0.2rem] font-mono text-[13px];
+  }
+  pre {
+    @apply rounded-lg;
+  }
+  pre > code {
+    @apply block min-w-full w-max px-4 py-3 text-[13px];
+  }
+  pre:has(> code) {
+    @apply relative max-w-full overflow-x-auto;
+  }
+  pre:has(> code) > button {
+    @apply flex items-center justify-center size-6 absolute right-2.5 top-2.5 outline-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] rounded-md hover:bg-accent dark:hover:bg-accent/50 text-muted-foreground hover:text-foreground [&_svg]:size-4;
+  }
+  blockquote {
+    @apply border-l-4 border-border pl-4;
+  }
+  ol {
+    @apply list-decimal ml-6;
+  }
+  ul {
+    @apply list-disc ml-6;
+  }
+  ol,
+  ul {
+    li {
+      @apply mt-2;
+
+      ol,
+      ul {
+        @apply mt-0 mb-0;
+      }
+    }
+  }
+  dl {
+    @apply border-b pb-3 my-6;
+    dt {
+      @apply border-t pt-3 mt-3 first:mt-0;
+    }
+    dd {
+      @apply mt-2;
+    }
+    dl {
+      @apply mt-4 border-b-0 pb-0 pl-8 my-0;
+    }
+  }
+  b,
+  strong {
+    @apply font-semibold;
+  }
+  > p,
+  blockquote,
+  ul,
+  ol,
+  dl,
+  pre {
+    @apply my-6;
+  }
+  > *:first-child {
+    @apply !mt-0;
+  }
+  > *:last-child {
+    @apply !mb-0;
+  }
+  table {
+    @apply w-full caption-bottom text-sm;
+    thead {
+      @apply [&_tr]:border-b;
+    }
+    tbody {
+      @apply [&_tr:last-child]:border-0;
+    }
+    tfoot {
+      @apply bg-muted/50 border-t font-medium [&>tr]:last:border-b-0;
+    }
+    tr {
+      @apply hover:bg-muted/50 border-b transition-colors;
+    }
+    th {
+      @apply text-foreground h-10 px-2 text-left align-middle font-medium [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px];
+    }
+    td {
+      @apply p-2 align-middle [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px];
+    }
+    caption {
+      @apply text-muted-foreground mt-4 text-sm;
+    }
+  }
+}
+
+.shiki {
+  @apply bg-muted dark:bg-muted/50;
+  color: var(--shiki-light);
+}
+
+.shiki span {
+  color: var(--shiki-light);
+}
+
+html.dark .shiki {
+  color: var(--shiki-dark);
+}
+
+html.dark .shiki span {
+  color: var(--shiki-dark);
+}
+
+#command-search > .command {
+  @apply sm:max-w-2xl;
+}
+
+.command [data-rsd-search-result] {
+  @apply flex-col items-start gap-1;
+}
+
+.command [data-rsd-search-title] {
+  @apply font-medium;
+}
+
+.command [data-rsd-search-snippet] {
+  @apply text-muted-foreground line-clamp-2 text-xs font-normal leading-snug;
+}
+
+.command mark {
+  @apply bg-search-highlight/50 text-foreground rounded-sm px-0.5 dark:bg-search-highlight/25;
+}

package/src/css/overrides.css

@@ -0,0 +1 @@
+/* Custom CSS overrides (loaded last). */

package/src/css/sources.css

@@ -0,0 +1 @@
+@source "../runtime/**/*.{astro,js,ts}";

package/src/icons/logos/claude.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m4.714 15.956 4.718-2.648.079-.23-.08-.128h-.23l-.79-.048-2.695-.073-2.337-.097-2.265-.122-.57-.121-.535-.704.055-.353.48-.321.685.06 1.518.104 2.277.157 1.651.098 2.447.255h.389l.054-.158-.133-.097-.103-.098-2.356-1.596-2.55-1.688-1.336-.972-.722-.491L2 6.223l-.158-1.008.655-.722.88.06.225.061.893.686 1.906 1.476 2.49 1.833.364.304.146-.104.018-.072-.164-.274-1.354-2.446-1.445-2.49-.644-1.032-.17-.619a2.972 2.972 0 0 1-.103-.729L6.287.133 6.7 0l.995.134.42.364.619 1.415L9.735 4.14l1.555 3.03.455.898.243.832.09.255h.159V9.01l.127-1.706.237-2.095.23-2.695.08-.76.376-.91.747-.492.583.28.48.685-.067.444-.286 1.851-.558 2.903-.365 1.942h.213l.243-.242.983-1.306 1.652-2.064.728-.82.85-.904.547-.431h1.032l.759 1.129-.34 1.166-1.063 1.347-.88 1.142-1.263 1.7-.79 1.36.074.11.188-.02 2.853-.606 1.542-.28 1.84-.315.832.388.09.395-.327.807-1.967.486-2.307.462-3.436.813-.043.03.049.061 1.548.146.662.036h1.62l3.018.225.79.522.473.638-.08.485-1.213.62-1.64-.389-3.825-.91-1.31-.329h-.183v.11l1.093 1.068 2.003 1.81 2.508 2.33.127.578-.321.455-.34-.049-2.204-1.657-.85-.747-1.925-1.62h-.127v.17l.443.649 2.343 3.521.122 1.08-.17.353-.607.213-.668-.122-1.372-1.924-1.415-2.168-1.141-1.943-.14.08-.674 7.254-.316.37-.728.28-.607-.461-.322-.747.322-1.476.388-1.924.316-1.53.285-1.9.17-.632-.012-.042-.14.018-1.432 1.967-2.18 2.945-1.724 1.845-.413.164-.716-.37.066-.662.401-.589 2.386-3.036 1.439-1.882.929-1.086-.006-.158h-.055L4.138 18.56l-1.13.146-.485-.456.06-.746.231-.243 1.907-1.312Z" fill="currentColor"></path></svg>

package/src/icons/logos/cursor.svg

@@ -0,0 +1 @@
+<svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><title>Cursor</title><path d="M11.503.131 1.891 5.678a.84.84 0 0 0-.42.726v11.188c0 .3.162.575.42.724l9.609 5.55a1 1 0 0 0 .998 0l9.61-5.55a.84.84 0 0 0 .42-.724V6.404a.84.84 0 0 0-.42-.726L12.497.131a1.01 1.01 0 0 0-.996 0M2.657 6.338h18.55c.263 0 .43.287.297.515L12.23 22.918c-.062.107-.229.064-.229-.06V12.335a.59.59 0 0 0-.295-.51l-9.11-5.257c-.109-.063-.064-.23.061-.23"  fill="currentColor"/></svg>

package/src/icons/logos/markdown.svg

@@ -0,0 +1 @@
+<svg stroke-linejoin="round" viewBox="0 0 22 16"><path fill-rule="evenodd" clip-rule="evenodd" d="M19.5 2.25H2.5C1.80964 2.25 1.25 2.80964 1.25 3.5V12.5C1.25 13.1904 1.80964 13.75 2.5 13.75H19.5C20.1904 13.75 20.75 13.1904 20.75 12.5V3.5C20.75 2.80964 20.1904 2.25 19.5 2.25ZM2.5 1C1.11929 1 0 2.11929 0 3.5V12.5C0 13.8807 1.11929 15 2.5 15H19.5C20.8807 15 22 13.8807 22 12.5V3.5C22 2.11929 20.8807 1 19.5 1H2.5ZM3 4.5H4H4.25H4.6899L4.98715 4.82428L7 7.02011L9.01285 4.82428L9.3101 4.5H9.75H10H11V5.5V11.5H9V7.79807L7.73715 9.17572L7 9.97989L6.26285 9.17572L5 7.79807V11.5H3V5.5V4.5ZM15 8V4.5H17V8H19.5L17 10.5L16 11.5L15 10.5L12.5 8H15Z" fill="currentColor"></path></svg>

package/src/icons/logos/openai.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M22.282 9.821a5.985 5.985 0 0 0-.516-4.91 6.046 6.046 0 0 0-6.51-2.9A6.065 6.065 0 0 0 4.981 4.18a5.985 5.985 0 0 0-3.998 2.9 6.046 6.046 0 0 0 .743 7.097 5.98 5.98 0 0 0 .51 4.911 6.051 6.051 0 0 0 6.515 2.9A5.985 5.985 0 0 0 13.26 24a6.056 6.056 0 0 0 5.772-4.206 5.99 5.99 0 0 0 3.997-2.9 6.056 6.056 0 0 0-.747-7.073zM13.26 22.43a4.476 4.476 0 0 1-2.876-1.04l.141-.081 4.779-2.758a.795.795 0 0 0 .392-.681v-6.737l2.02 1.168a.071.071 0 0 1 .038.052v5.583a4.504 4.504 0 0 1-4.494 4.494zM3.6 18.304a4.47 4.47 0 0 1-.535-3.014l.142.085 4.783 2.759a.771.771 0 0 0 .78 0l5.843-3.369v2.332a.08.08 0 0 1-.033.062L9.74 19.95a4.5 4.5 0 0 1-6.14-1.646zM2.34 7.896a4.485 4.485 0 0 1 2.366-1.973V11.6a.766.766 0 0 0 .388.676l5.815 3.355-2.02 1.168a.076.076 0 0 1-.071 0l-4.83-2.786A4.504 4.504 0 0 1 2.34 7.872zm16.597 3.855-5.833-3.387L15.119 7.2a.076.076 0 0 1 .071 0l4.83 2.791a4.494 4.494 0 0 1-.676 8.105v-5.678a.79.79 0 0 0-.407-.667zm2.01-3.023-.141-.085-4.774-2.782a.776.776 0 0 0-.785 0L9.409 9.23V6.897a.066.066 0 0 1 .028-.061l4.83-2.787a4.5 4.5 0 0 1 6.68 4.66zm-12.64 4.135-2.02-1.164a.08.08 0 0 1-.038-.057V6.075a4.5 4.5 0 0 1 7.375-3.453l-.142.08-4.778 2.758a.795.795 0 0 0-.393.681zm1.097-2.365 2.602-1.5 2.607 1.5v2.999l-2.597 1.5-2.607-1.5Z" fill="currentColor"></path></svg>

package/src/index.js

@@ -0,0 +1 @@
+export { default as reallySimpleDocs } from "./astro/index.js";

package/src/runtime/components/BaseLayout.astro

@@ -0,0 +1,83 @@
+---
+import "virtual:reallysimpledocs/styles.css";
+import config from "virtual:reallysimpledocs/config";
+import { getSite } from "../lib/site.js";
+
+const { title, description, pagePath = "/" } = Astro.props;
+const site = getSite(config);
+const metaDescription = description || site.description || "";
+const metaTitle = pagePath === "/" ? `${site.title} | ${metaDescription}` : `${title || metaDescription} | ${site.title}`;
+const siteUrl = Astro.site?.toString().replace(/\/$/, "") || site.url || "";
+const absoluteUrl = `${siteUrl}${pagePath}`;
+const assetsBase = config.assetsBase || "/assets";
+const favicon = site.assets?.favicon || site.favicon || "";
+const appleTouchIcon = site.assets?.appleTouchIcon || site.appleTouchIcon || "";
+const socialImage = site.assets?.socialImage || site.socialImage || "";
+const assetPath = (value) => {
+  const path = String(value || "");
+  if (!path || path.startsWith("http") || path.startsWith("/")) return path;
+  return `${assetsBase.replace(/\/$/, "")}/${path}`;
+};
+const absoluteAssetUrl = (value) => {
+  const path = assetPath(value);
+  return path.startsWith("http") ? path : `${siteUrl}${path}`;
+};
+---
+
+<!doctype html>
+<html lang="en">
+  <head>
+    <script is:inline>
+      (() => {
+        try {
+          const stored = localStorage.getItem("themeMode");
+          if (stored ? stored === "dark" : matchMedia("(prefers-color-scheme: dark)").matches) {
+            document.documentElement.classList.add("dark");
+          }
+        } catch (_) {}
+
+        const apply = (dark) => {
+          document.documentElement.classList.toggle("dark", dark);
+          try {
+            localStorage.setItem("themeMode", dark ? "dark" : "light");
+          } catch (_) {}
+        };
+
+        document.addEventListener("basecoat:theme", (event) => {
+          const mode = event.detail?.mode;
+          apply(mode === "dark" ? true : mode === "light" ? false : !document.documentElement.classList.contains("dark"));
+        });
+      })();
+    </script>
+    <meta charset="utf-8" />
+    <meta http-equiv="Content-Language" content="en" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>{metaTitle}</title>
+    <meta name="description" content={metaDescription} />
+    <meta name="title" content={metaTitle} />
+    {site.keywords && <meta name="keywords" content={site.keywords.join(",")} />}
+    {favicon && <link rel="icon" type="image/svg+xml" href={assetPath(favicon)} />}
+    {appleTouchIcon && <link rel="apple-touch-icon" sizes="180x180" href={assetPath(appleTouchIcon)} />}
+    <meta property="og:type" content="website" />
+    <meta property="og:url" content={absoluteUrl} />
+    <meta property="og:title" content={metaTitle} />
+    <meta property="og:description" content={metaDescription} />
+    {socialImage && <meta property="og:image" content={absoluteAssetUrl(socialImage)} />}
+    <meta property="og:site_name" content={site.title} />
+    <meta property="og:locale" content="en_US" />
+    {site.author?.name && <meta property="og:author" content={site.author.name} />}
+    <meta name="twitter:card" content="summary_large_image" />
+    <meta name="twitter:url" content={absoluteUrl} />
+    <meta name="twitter:title" content={metaTitle} />
+    <meta name="twitter:description" content={metaDescription} />
+    {socialImage && <meta name="twitter:image" content={absoluteAssetUrl(socialImage)} />}
+    {site.author?.x && <meta name="twitter:creator" content={site.author.x} />}
+    <script>
+      import "basecoat-css/all.min";
+      import "../scripts/copy-code.js";
+    </script>
+  </head>
+  <body>
+    <slot />
+  </body>
+</html>