@publish.os/nextjs 0.0.1-alpha.90 → 0.0.1-alpha.91

package/dist/route-metadata-og-image-BeKKFHg7.d.ts

@@ -0,0 +1,58 @@
+type OgImageEntryLike = {
+    key: string;
+    routePath: string;
+    title: string;
+    description?: string;
+    source: "asset" | "generated" | "remote";
+    url: string;
+    width: number;
+    height: number;
+    alt: string;
+    group?: string;
+    logo?: {
+        dataUri?: string;
+        height?: number;
+        kind: "logo" | "mark" | "wordmark";
+        url: string;
+        width?: number;
+    };
+    siteName?: string;
+    siteUrl?: string;
+    label?: string;
+    background?: string;
+    textPrimary?: string;
+    textSecondary?: string;
+    accent?: string;
+    stroke?: string;
+    theme?: "light" | "dark";
+    fonts?: {
+        main: OgFontRoleLike;
+        mono: OgFontRoleLike;
+    };
+    emoji?: Readonly<Record<string, string>>;
+    fallbackGlyphs?: Partial<Record<"main" | "mono", Readonly<Record<string, string>>>>;
+    fallbackFonts?: ReadonlyArray<{
+        family: string;
+        data: string;
+        style: "normal" | "italic";
+        weight: number;
+    }>;
+};
+type OgManifestLike = {
+    width: number;
+    height: number;
+    generated: Record<string, OgImageEntryLike>;
+};
+type OgFontRoleLike = {
+    family: string;
+    files?: ReadonlyArray<{
+        data: string;
+        path?: string;
+        probe?: string;
+        style: "normal" | "italic";
+        weight: number;
+    }>;
+    sourceType: "google" | "local";
+};
+
+export type { OgManifestLike as O };

package/dist/search.js

@@ -16,11 +16,11 @@ import {
 } from "react";
 
 // src/lib/hosting/framework-paths.ts
-var FRAMEWORK_PREFIX = "/publishos", ASSET_PREFIX = `${FRAMEWORK_PREFIX}/assets`, SITE_API_PREFIX = `${FRAMEWORK_PREFIX}/api`, PAGEFIND_PREFIX = `${ASSET_PREFIX}/pagefind`, PAGEFIND_MODULE_URL = `${PAGEFIND_PREFIX}/pagefind.js`, PAGEFIND_ENTRY_URL = `${PAGEFIND_PREFIX}/pagefind-entry.json`, IMAGE_OPTIMIZER_PATH = `${SITE_API_PREFIX}/image`;
-var OG_SERVICE_PREFIX = `${SITE_API_PREFIX}/og`, PUBLIC_ASSET_DIRECTORY = "publishos/assets", PUBLIC_FONT_DIRECTORY = `${PUBLIC_ASSET_DIRECTORY}/_publishos/fonts`, PUBLIC_PAGEFIND_DIRECTORY = `public/${PUBLIC_ASSET_DIRECTORY}/pagefind`, FRAMEWORK_PROXY_MATCHER = `/((?!${FRAMEWORK_PREFIX.slice(1)}(?:/|$)|_next/static|_next/image|_next/webpack-hmr).*)`;
+var FRAMEWORK_PREFIX = "/publishos", SOURCE_ASSET_PREFIX = `${FRAMEWORK_PREFIX}/assets`, INTERNAL_PREFIX = `${FRAMEWORK_PREFIX}/internal`, SITE_API_PREFIX = `${FRAMEWORK_PREFIX}/api`, SEARCH_PREFIX = `${INTERNAL_PREFIX}/search`, PAGEFIND_MODULE_URL = `${SEARCH_PREFIX}/pagefind.js`, PAGEFIND_ENTRY_URL = `${SEARCH_PREFIX}/pagefind-entry.json`, IMAGE_OPTIMIZER_PATH = `${SITE_API_PREFIX}/image`;
+var OG_SERVICE_PREFIX = `${SITE_API_PREFIX}/og`, PUBLIC_INTERNAL_DIRECTORY = INTERNAL_PREFIX.slice(1), PUBLIC_FONT_DIRECTORY = `${PUBLIC_INTERNAL_DIRECTORY}/fonts`, PUBLIC_SEARCH_DIRECTORY = `public/${PUBLIC_INTERNAL_DIRECTORY}/search`, FRAMEWORK_PROXY_MATCHER = `/((?!${FRAMEWORK_PREFIX.slice(1)}(?:/|$)|_next/static|_next/image|_next/webpack-hmr).*)`;
 
 // src/modules/search/search.tsx
-import { jsx } from "react/jsx-runtime";
+import { jsx } from "@publish.os/nextjs/jsx-runtime";
 var EMPTY_SEARCH_OUTPUT = {
   items: [],
   nextOffset: null,
@@ -176,20 +176,18 @@ async function runPagefindSearch(input) {
   let status = await fetchSearchStatus(input.signal), blockedByStatus = status ? statusOutput(status) : null;
   return blockedByStatus || await withPagefindIndex(status?.revision, async (pagefind) => {
     let limit = normalized.limit ?? DEFAULT_SEARCH_LIMIT, offset = normalized.offset ?? 0, result = await pagefind.search(normalized.q, {
-      filters: pagefindFilters(normalized.filters),
-      limit,
-      offset
+      filters: pagefindFilters(normalized.filters)
     });
     if (!result) return EMPTY_SEARCH_OUTPUT;
-    let items = await Promise.all(
-      result.results.map(
+    let total = result.results.length, page = result.results.slice(offset, offset + limit), items = await Promise.all(
+      page.map(
         async (pagefindResult) => toSearchResult({
           data: await pagefindResult.data(),
           fallbackId: pagefindResult.id,
           score: pagefindResult.score
         })
       )
-    ), total = result.unfilteredResultCount ?? items.length, nextOffset = offset + limit < total ? offset + limit : null;
+    ), nextOffset = offset + limit < total ? offset + limit : null;
     return {
       items,
       nextOffset,

package/dist/theme-scope.js

@@ -2,7 +2,7 @@
 
 // src/lib/theme/theme-scope.tsx
 import { createContext, use } from "react";
-import { jsx } from "react/jsx-runtime";
+import { jsx } from "@publish.os/nextjs/jsx-runtime";
 var ROOT_SCOPE = Object.freeze({
   "data-group": "",
   "data-theme-root": ""

package/dist/{types-BzkZty3r.d.ts → types-J2w_puPF.d.ts}

@@ -116,10 +116,6 @@ type ManifestLike = {
     attribution?: Record<string, ResolvedAttribution>;
     contentHash: string;
 };
-type RootPageProps = {
-    site: SiteData;
-    tree: TreeNode[];
-};
 type LayoutProps = {
     children: React.ReactNode;
     site: SiteData;
@@ -128,20 +124,5 @@ type LayoutProps = {
     currentPath: string;
     group: string;
 };
-type PageProps<TMeta extends Record<string, unknown> = Record<string, unknown>> = {
-    site: SiteData;
-    tree: TreeNode[];
-    node: TreeNode;
-    page: PageData<TMeta>;
-    currentPath: string;
-    group: string;
-};
-type IndexPageProps = {
-    site: SiteData;
-    tree: TreeNode[];
-    node: TreeNode;
-    currentPath: string;
-    group: string;
-};
 
-export type { IndexPageProps as I, LayoutProps as L, ManifestLike as M, PageStatus as P, ResolvedAttribution as R, PageProps as a, RootPageProps as b };
+export type { LayoutProps as L, ManifestLike as M, PageStatus as P };

package/dist/types-sM2g9nW0.d.ts

@@ -0,0 +1,12 @@
+import { MDXComponents as MDXComponents$1 } from 'mdx/types.js';
+import { ReactNode } from 'react';
+
+type MDXComponents = MDXComponents$1;
+type MdxErrorBoundaryProps = {
+    errorMessage?: string;
+    pageId?: string;
+    slug?: string;
+    children: ReactNode;
+};
+
+export type { MdxErrorBoundaryProps as M, MDXComponents as a };

package/dist/types.d.ts

@@ -246,6 +246,7 @@ type PageProps<TMeta extends Record<string, unknown> = Record<string, unknown>>
     tree: TreeNode[];
     node: TreeNode;
     page: PageData<TMeta>;
+    markdownRevision?: string;
     currentPath: string;
     group: string;
 };

package/dist/utils/heading-ids.js

@@ -1,6 +1,29 @@
 // src/components/mdx/heading-ids.ts
 import { isValidElement } from "react";
-var SELF_CLOSING_TAG_RE = new RegExp("<[^>]+/>", "g"), PAIRED_TAG_RE = /<\/?\w[^>]*>/g, MDX_BOLD_RE = /\*\*(.*?)\*\*/g, MDX_ITALIC_RE = /\*(.*?)\*/g, MDX_UNDERLINE_BOLD_RE = /__(.*?)__/g, MDX_UNDERLINE_ITALIC_RE = /_(.*?)_/g, MDX_STRIKETHROUGH_RE = /~~(.*?)~~/g, MDX_INLINE_CODE_RE = /`(.*?)`/g, MDX_LINK_RE = /\[(.*?)\]\(.*?\)/g, NON_ALPHANUMERIC_RE = /[^a-z0-9]+/g, LEADING_TRAILING_HYPHEN_RE = /^-+|-+$/g, LEADING_DIGIT_RE = /^(\d)/, HEADING_RE = /^(#{1,6})[ \t]+(.+?)\s*#*\s*$/gm, FENCED_CODE_RE = /```[\s\S]*?```|~~~[\s\S]*?~~~/g;
+
+// src/components/mdx/heading-string.ts
+var SELF_CLOSING_TAG_RE = /<[^>]+\/>/g, PAIRED_TAG_RE = /<\/?\w[^>]*>/g, MDX_BOLD_RE = /\*\*(.*?)\*\*/g, MDX_ITALIC_RE = /\*(.*?)\*/g, MDX_UNDERLINE_BOLD_RE = /__(.*?)__/g, MDX_UNDERLINE_ITALIC_RE = /_(.*?)_/g, MDX_STRIKETHROUGH_RE = /~~(.*?)~~/g, MDX_INLINE_CODE_RE = /`(.*?)`/g, MDX_LINK_RE = /\[(.*?)\]\(.*?\)/g, NON_ALPHANUMERIC_RE = /[^a-z0-9]+/g, LEADING_TRAILING_HYPHEN_RE = /^-+|-+$/g, LEADING_DIGIT_RE = /^(\d)/;
+function cleanHeadingString(input) {
+  return input.replace(SELF_CLOSING_TAG_RE, "").replace(PAIRED_TAG_RE, "").replace(MDX_BOLD_RE, "$1").replace(MDX_ITALIC_RE, "$1").replace(MDX_UNDERLINE_BOLD_RE, "$1").replace(MDX_UNDERLINE_ITALIC_RE, "$1").replace(MDX_STRIKETHROUGH_RE, "$1").replace(MDX_INLINE_CODE_RE, "$1").replace(MDX_LINK_RE, "$1").trim();
+}
+function headingStringToHTMLId(input) {
+  let text = cleanHeadingString(input);
+  return text ? text.toLowerCase().replace(NON_ALPHANUMERIC_RE, "-").replace(LEADING_TRAILING_HYPHEN_RE, "").replace(LEADING_DIGIT_RE, "id-$1") || "heading" : "empty-heading";
+}
+function createHeadingStringIdGenerator() {
+  let nextSuffix = /* @__PURE__ */ new Map(), usedIds = /* @__PURE__ */ new Set();
+  return (input) => {
+    let baseId = headingStringToHTMLId(input);
+    if (baseId === "empty-heading") return baseId;
+    let suffix = nextSuffix.get(baseId) ?? 0, id = suffix === 0 ? baseId : `${baseId}-${suffix}`;
+    for (; usedIds.has(id); )
+      suffix += 1, id = `${baseId}-${suffix}`;
+    return nextSuffix.set(baseId, suffix + 1), usedIds.add(id), id;
+  };
+}
+
+// src/components/mdx/heading-ids.ts
+var HEADING_RE = /^(#{1,6})[ \t]+(.+?)\s*#*\s*$/gm, FENCED_CODE_RE = /```[\s\S]*?```|~~~[\s\S]*?~~~/g;
 function extractText(node) {
   if (typeof node == "string") return node;
   if (typeof node == "number") return String(node);
@@ -14,26 +37,22 @@ function extractText(node) {
   return "";
 }
 function cleanHeadingText(input) {
-  return (typeof input == "string" ? input : extractText(input)).replace(SELF_CLOSING_TAG_RE, "").replace(PAIRED_TAG_RE, "").replace(MDX_BOLD_RE, "$1").replace(MDX_ITALIC_RE, "$1").replace(MDX_UNDERLINE_BOLD_RE, "$1").replace(MDX_UNDERLINE_ITALIC_RE, "$1").replace(MDX_STRIKETHROUGH_RE, "$1").replace(MDX_INLINE_CODE_RE, "$1").replace(MDX_LINK_RE, "$1").trim();
+  let text = typeof input == "string" ? input : extractText(input);
+  return cleanHeadingString(text);
 }
 function slugify(text) {
-  return text.toLowerCase().replace(NON_ALPHANUMERIC_RE, "-").replace(LEADING_TRAILING_HYPHEN_RE, "").replace(LEADING_DIGIT_RE, "id-$1");
+  return headingStringToHTMLId(text);
 }
 function headingToHTMLId(input) {
   try {
-    return slugify(cleanHeadingText(input)) || "empty-heading";
+    return slugify(cleanHeadingText(input)) || (cleanHeadingText(input) ? "heading" : "empty-heading");
   } catch {
     return "empty-heading";
   }
 }
 function createHeadingIdGenerator() {
-  let usedIds = /* @__PURE__ */ new Map();
-  return (input) => {
-    let baseId = headingToHTMLId(input);
-    if (baseId === "empty-heading") return baseId;
-    let count = usedIds.get(baseId) ?? 0;
-    return usedIds.set(baseId, count + 1), count === 0 ? baseId : `${baseId}-${count}`;
-  };
+  let headingId = createHeadingStringIdGenerator();
+  return (input) => headingId(cleanHeadingText(input));
 }
 function extractMdxHeadings(content = "", levels) {
   let [minDepth, maxDepth] = levels, headingId = createHeadingIdGenerator(), headings = [], searchableContent = content.replace(FENCED_CODE_RE, "");

package/dist/utils/toc-selection.d.ts

@@ -0,0 +1,7 @@
+type HeadingPosition = {
+    id: string;
+    top: number;
+};
+declare function findActiveHeadingIndex(headings: readonly HeadingPosition[], readingLine: number, isAtBottom?: boolean): number;
+
+export { type HeadingPosition, findActiveHeadingIndex };

package/dist/utils/toc-selection.js

@@ -0,0 +1,14 @@
+// src/components/block/toc/selection.ts
+function findActiveHeadingIndex(headings, readingLine, isAtBottom = !1) {
+  if (headings.length === 0) return -1;
+  if (isAtBottom) return headings.length - 1;
+  let low = 0, high = headings.length;
+  for (; low < high; ) {
+    let middle = low + Math.floor((high - low) / 2), heading = headings[middle];
+    heading && heading.top <= readingLine ? low = middle + 1 : high = middle;
+  }
+  return Math.max(0, low - 1);
+}
+export {
+  findActiveHeadingIndex
+};

package/dist/validate-local-source-SV44DBQT.js

@@ -0,0 +1,16 @@
+import {
+  validateLocalSource
+} from "./chunk-ORIUWJBQ.js";
+import "./chunk-NNBJZPFM.js";
+import "./chunk-F3AGNDF4.js";
+import "./chunk-7NY22B5U.js";
+import "./chunk-UYGCOWRF.js";
+import "./chunk-EFO6AWXN.js";
+import "./chunk-5KAD7W53.js";
+import "./chunk-WL75GQ5M.js";
+import "./chunk-AI2UULNX.js";
+import "./chunk-5J3YUNRY.js";
+import "./chunk-22RSSUNV.js";
+export {
+  validateLocalSource
+};

package/dist/validate-publish-os-source-NZJF3TB2.js

@@ -0,0 +1,14 @@
+import {
+  validatePublishOsSource
+} from "./chunk-F3AGNDF4.js";
+import "./chunk-7NY22B5U.js";
+import "./chunk-UYGCOWRF.js";
+import "./chunk-EFO6AWXN.js";
+import "./chunk-5KAD7W53.js";
+import "./chunk-WL75GQ5M.js";
+import "./chunk-AI2UULNX.js";
+import "./chunk-5J3YUNRY.js";
+import "./chunk-22RSSUNV.js";
+export {
+  validatePublishOsSource
+};

package/init/seed/minimal/publish.os/assets/blog/hello-world.svg

@@ -0,0 +1,13 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1600" height="800" viewBox="0 0 1600 800" fill="none">
+  <rect width="1600" height="800" fill="#101214"/>
+  <g stroke="#343A40" stroke-width="2">
+    <path d="M160 240H1440M160 320H1440M160 480H1440M160 560H1440"/>
+    <path d="M160 400H560C640 400 640 280 720 280H880C960 280 960 400 1040 400H1440"/>
+    <path d="M160 400H560C640 400 640 520 720 520H880C960 520 960 400 1040 400H1440"/>
+  </g>
+  <path d="M160 400H1440" stroke="#A9CFFF" stroke-width="3"/>
+  <circle cx="800" cy="400" r="50" fill="#101214" stroke="#A9CFFF" stroke-width="3"/>
+  <path d="m786 383-17 17 17 17m28-34 17 17-17 17" stroke="#A9CFFF" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/>
+  <g fill="#727C86"><circle cx="160" cy="240" r="4"/><circle cx="160" cy="320" r="4"/><circle cx="160" cy="480" r="4"/><circle cx="160" cy="560" r="4"/></g>
+  <circle cx="160" cy="400" r="4" fill="#A9CFFF"/>
+</svg>

package/init/seed/minimal/publish.os/assets/favicon.dark.svg

@@ -0,0 +1,13 @@
+<svg width="512" height="512" viewBox="0 0 512 512" fill="none" xmlns="http://www.w3.org/2000/svg">
+<rect width="512" height="512" rx="120" fill="#181818"/>
+<rect x="6" y="6" width="500" height="500" rx="114" stroke="white" stroke-opacity="0.18" stroke-width="12"/>
+<g clip-path="url(#clip0_1715_626)">
+<path d="M273.137 237.996L306.335 157.85L343.538 173.259L310.7 252.535L372.044 191.192L400.518 219.666L339.839 280.343L419.988 247.145L435.398 284.348L307.078 337.498L312.354 339.684H196.574L201.851 337.498L73.5332 284.348L88.9434 247.145L166.473 279.258L106.881 219.666L135.354 191.192L194.937 250.774L162.829 173.259L200.032 157.85L232.869 237.124V152.184H273.137V237.996Z" fill="white"/>
+<rect x="68.5" y="319.551" width="375" height="40.2685" fill="white"/>
+</g>
+<defs>
+<clipPath id="clip0_1715_626">
+<rect width="375" height="375" fill="white" transform="translate(68.5 68.5)"/>
+</clipPath>
+</defs>
+</svg>

package/init/seed/minimal/publish.os/assets/favicon.svg

@@ -0,0 +1,13 @@
+<svg width="512" height="512" viewBox="0 0 512 512" fill="none" xmlns="http://www.w3.org/2000/svg">
+<rect width="512" height="512" rx="120" fill="white"/>
+<rect x="6" y="6" width="500" height="500" rx="114" stroke="#291E00" stroke-opacity="0.2" stroke-width="12"/>
+<g clip-path="url(#clip0_1715_611)">
+<path d="M273.137 237.996L306.335 157.85L343.538 173.259L310.7 252.535L372.044 191.192L400.518 219.666L339.839 280.343L419.988 247.145L435.398 284.348L307.078 337.498L312.354 339.684H196.574L201.851 337.498L73.5332 284.348L88.9434 247.145L166.473 279.258L106.881 219.666L135.354 191.192L194.937 250.774L162.829 173.259L200.032 157.85L232.869 237.124V152.184H273.137V237.996Z" fill="#161000"/>
+<rect x="68.5" y="319.551" width="375" height="40.2685" fill="#161000"/>
+</g>
+<defs>
+<clipPath id="clip0_1715_611">
+<rect width="375" height="375" fill="white" transform="translate(68.5 68.5)"/>
+</clipPath>
+</defs>
+</svg>

package/init/seed/minimal/publish.os/blog/content/hello-world.mdx

@@ -0,0 +1,48 @@
+---
+title: Hello, world.
+description: Publish your first post and make this blog your own.
+publishedAt: 2026-10-20
+authors: [Matthew B]
+tags: [Press]
+image:
+  src: /assets/blog/hello-world.svg
+  alt: A code symbol where several publishing paths meet.
+---
+
+Use this blog to share news, releases, and what you learn. Edit this post in `publish.os/blog/content/hello-world.mdx`.
+
+## Add a post
+
+Create another `.mdx` file in `publish.os/blog/content/`:
+
+```mdx
+---
+title: A small beginning
+description: Why this project exists.
+publishedAt: 2026-10-21
+authors: [Matthew B]
+---
+
+This project starts with one problem and one useful solution.
+```
+
+The blog index shows published posts, newest first. Set `publishedAt` to edit the publication date. 
+
+## Customize the blog
+
+Edit `index.tsx` to change the post list at `/blog`. Edit `page.tsx` to change individual posts. The shared [theme](/docs/themes) supplies colors and typography.
+
+```txt
+publish.os/blog/
+├── layout.tsx
+├── index.tsx
+├── page.tsx
+└── content/
+    ├── hello-world.mdx
+    └── series-a.mdx
+```
+
+
+Edit `layout.tsx` to change the blog layout.
+
+Add `tags` and an `image` with `src` and `alt` to a post's frontmatter to customize its header. Keep local images in `publish.os/assets/` and reference them with `/assets/` paths.

package/init/seed/minimal/publish.os/blog/content/series-a.mdx

@@ -0,0 +1,11 @@
+---
+title: Our $5M Series A
+description: A fictional funding announcement for your starter blog.
+publishedAt: 2026-10-18
+authors: [Matthew B]
+tags: [Company news]
+---
+
+Example Co. raised $5 million in Series A funding to help teams publish useful documentation. We will use the investment to grow the team and improve the product.
+
+This is a fictional announcement for the starter site. Replace it with your own news.

package/init/seed/minimal/publish.os/blog/index.tsx

@@ -0,0 +1,82 @@
+import type {
+  IndexPageProps,
+  PageNode,
+  TreeNode,
+} from "@publish.os/nextjs/types";
+import { prettyDate } from "@publish.os/nextjs/utils/pretty-date";
+import Link from "next/link";
+
+function pageNodes(nodes: TreeNode[]): PageNode[] {
+  return nodes.flatMap((node) => {
+    if (node.type === "page") return [node];
+    if (node.type === "section" || node.type === "folder") {
+      return pageNodes(node.children);
+    }
+    return [];
+  });
+}
+
+export default function BlogIndex({ node, tree }: IndexPageProps) {
+  const posts = pageNodes(tree)
+    .filter((page) => page.status === "published")
+    .sort(
+      (a, b) =>
+        (b.publishedAt ?? "").localeCompare(a.publishedAt ?? "") ||
+        a.path.localeCompare(b.path),
+    );
+
+  return (
+    <section className="w-full px-4 py-12 md:px-5 lg:px-6 lg:py-16">
+      <h1 className="mb-10 text-balance text-5xl font-medium leading-none tracking-tight text-foreground-1">
+        {node.title}
+      </h1>
+      {posts.length > 0 ? (
+        <ul>
+          {posts.map((post) => {
+            const authors = post.authors
+              .map((author) => author.name)
+              .join(", ");
+            const date = prettyDate(post.publishedAt);
+
+            return (
+              <li
+                className="border-b border-stroke-4 last:border-b-0"
+                key={post.path}
+              >
+                <Link
+                  className="-mx-4 flex min-h-12 items-center gap-6 rounded-card px-4 py-4 text-sm text-foreground-1 hover:bg-surface-hover active:bg-surface-active focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-focus-stroke"
+                  href={post.path}
+                  title={post.title}
+                >
+                  <span className="min-w-0 flex-1 truncate">{post.title}</span>
+                  <span className="hidden min-w-0 max-w-[45%] items-baseline gap-1.5 text-foreground-3 md:flex">
+                    {authors ? (
+                      <span className="truncate">{authors}</span>
+                    ) : null}
+                    {authors && date ? <span aria-hidden="true">·</span> : null}
+                    {date ? (
+                      <time
+                        className="shrink-0 whitespace-nowrap"
+                        dateTime={post.publishedAt}
+                      >
+                        {date}
+                      </time>
+                    ) : null}
+                  </span>
+                  <span
+                    aria-hidden="true"
+                    className="shrink-0 text-foreground-2 md:hidden rtl:rotate-180"
+                  >
+                    →
+                  </span>
+                </Link>
+              </li>
+            );
+          })}
+        </ul>
+      ) : (
+        <p className="text-sm text-foreground-2">No posts yet.</p>
+      )}
+    </section>
+  );
+}

package/init/seed/minimal/publish.os/blog/layout.tsx

@@ -0,0 +1,13 @@
+import type { LayoutProps } from "@publish.os/nextjs/types";
+
+export default function BlogLayout({ children }: LayoutProps) {
+  return (
+    <main
+      className="mx-auto flex min-h-0 min-w-0 w-full max-w-(--layout-site-max-width) flex-1 flex-col border-x border-stroke-3 bg-surface-1"
+      id="main-content"
+      tabIndex={-1}
+    >
+      {children}
+    </main>
+  );
+}

package/init/seed/minimal/publish.os/blog/page.tsx

@@ -0,0 +1,76 @@
+import { CaretLeftIcon } from "@phosphor-icons/react/ssr";
+import { MDX } from "@publish.os/nextjs/mdx";
+import type { PageProps } from "@publish.os/nextjs/types";
+import { prettyDate } from "@publish.os/nextjs/utils/pretty-date";
+import Image from "next/image";
+import Link from "next/link";
+import { CopyLink } from "../components/blog/copy-link";
+
+type BlogMeta = {
+  image?: { src: string; alt: string };
+};
+
+export default function BlogLeaf({ page }: PageProps<BlogMeta>) {
+  const authors = page.authors.map((author) => author.name).join(", ");
+  const date = prettyDate(page.publishedAt);
+
+  return (
+    <div className="flex min-h-0 min-w-0 flex-1 flex-col px-4 pt-6 md:px-5 lg:px-6 lg:pt-8">
+      <nav aria-label="Blog" className="mb-8 lg:mb-12">
+        <Link
+          className="-ms-2 inline-flex min-h-11 items-center gap-1.5 rounded-button px-2 text-sm text-foreground-3 hover:text-foreground-1 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-focus-stroke"
+          href="/blog"
+        >
+          <CaretLeftIcon
+            aria-hidden="true"
+            className="size-3.5 shrink-0 rtl:rotate-180"
+          />
+          Blog
+        </Link>
+      </nav>
+      <article className="mx-auto flex min-w-0 w-full max-w-4xl flex-1 flex-col wrap-anywhere">
+        <header>
+          <div className="mx-auto w-full max-w-2xl">
+            <h1 className="text-balance text-center text-4xl font-medium leading-tight tracking-tight text-foreground-1 md:text-5xl">
+              {page.title}
+            </h1>
+          </div>
+          {page.meta.image ? (
+            <Image
+              alt={page.meta.image.alt}
+              className="mt-10 aspect-2/1 w-full rounded-media border border-stroke-3 object-cover"
+              height={800}
+              priority
+              sizes="(max-width: 896px) 100vw, 896px"
+              src={page.meta.image.src}
+              width={1600}
+            />
+          ) : null}
+          <div className="mx-auto w-full max-w-2xl">
+            {page.description ? (
+              <p className="mt-12 text-pretty text-center text-base italic leading-7 text-foreground-2">
+                {page.description}
+              </p>
+            ) : null}
+            <hr className="my-10 border-stroke-3" />
+          </div>
+        </header>
+        <div className="mx-auto flex w-full max-w-2xl flex-1 flex-col">
+          <div className="markdown-prose min-w-0 flex-1">
+            <MDX page={page} />
+          </div>
+          <div className="mx-auto mt-12 mb-24 flex w-full max-w-2xl flex-wrap items-center justify-between gap-3 border-t border-stroke-3 pt-6">
+            {authors || date ? (
+              <p className="flex flex-wrap items-baseline gap-x-1.5 text-sm text-foreground-3">
+                {authors ? <span>{authors}</span> : null}
+                {authors && date ? <span aria-hidden="true">·</span> : null}
+                {date ? <time dateTime={page.publishedAt}>{date}</time> : null}
+              </p>
+            ) : null}
+            <CopyLink className="ms-auto" path={page.path} />
+          </div>
+        </div>
+      </article>
+    </div>
+  );
+}

package/init/seed/minimal/publish.os/components/blog/copy-link.tsx

@@ -0,0 +1,64 @@
+"use client";
+
+import { Link } from "@components/ui/link";
+import { LinkSimpleIcon } from "@phosphor-icons/react/ssr";
+import { useState } from "react";
+
+export function CopyLink({
+  className,
+  path,
+}: {
+  className?: string;
+  path: string;
+}) {
+  const [status, setStatus] = useState<"idle" | "pending" | "copied" | "error">(
+    "idle",
+  );
+
+  async function copyLink() {
+    setStatus("pending");
+    try {
+      await navigator.clipboard.writeText(
+        new URL(path, window.location.origin).href,
+      );
+      setStatus("copied");
+    } catch {
+      setStatus("error");
+    }
+  }
+
+  return (
+    <div className={className}>
+      <Link
+        aria-busy={status === "pending" || undefined}
+        className="inline-flex min-h-11 items-center text-foreground-3 hover:text-foreground-1 active:text-foreground-1 motion-safe:transition-[color,scale] motion-safe:duration-150 motion-safe:active:scale-[0.96] motion-reduce:transition-none"
+        href={path}
+        leftIcon={<LinkSimpleIcon aria-hidden="true" />}
+        onClick={(event) => {
+          if (event.metaKey || event.ctrlKey || event.shiftKey || event.altKey)
+            return;
+          event.preventDefault();
+          if (status !== "pending") void copyLink();
+        }}
+        prefetch={false}
+        size="xs"
+      >
+        Copy link
+      </Link>
+      <p
+        className={
+          status === "error"
+            ? "mt-2 max-w-60 text-sm text-foreground-2"
+            : "sr-only"
+        }
+        role="status"
+      >
+        {status === "copied"
+          ? "Link copied."
+          : status === "error"
+            ? "Could not copy. Try again, or copy the address from your browser."
+            : ""}
+      </p>
+    </div>
+  );
+}

package/init/seed/minimal/publish.os/docs/content/get-started.mdx

@@ -1,7 +1,6 @@
 ---
 title: Get started
 description: Preview your site and make your first change.
-order: 1
 ---
 
 A publishOS site starts with a folder. The `publish.os/` folder contains your content, theme, and configuration.
@@ -30,7 +29,7 @@ Use Markdown for normal text. You can use **bold text**, _italic text_, and `cod
 
 You can also use MDX components to add interactive elements to your pages.
 
-Use [callouts](/docs/callouts) to add notes, warnings, and useful context. The callout guide shows every color and style.
+Use the [blog](/blog) to share updates alongside your documentation.
 
 You can show a keyboard shortcut such as <kbd>Ctrl</kbd>+<kbd>Enter</kbd>.
 
@@ -47,4 +46,4 @@ description: Add a page to your site.
 Each MDX file contains one page.
 ```
 
-Next try creating or modifying <a href="/docs/groups">groups</a> or customizing your <a href="/docs/themes">theme</a>.
+Next, organize your [groups](/docs/groups) or customize your [theme](/docs/themes).