blume 2.2.0 → 2.2.2

package/dist/cli/index.js

@@ -725,24 +725,24 @@ var main = defineCommand({
     version: getBlumeVersion()
   },
   subCommands: {
-    add: lazyCommand(commandMeta.add, () => import("./chunk-th0pgaj5.js"), "addCommand"),
-    audit: lazyCommand(commandMeta.audit, () => import("./chunk-49r370mb.js"), "auditCommand"),
-    build: lazyCommand(commandMeta.build, () => import("./chunk-xt0qvz1t.js"), "buildCommand"),
-    check: lazyCommand(commandMeta.check, () => import("./chunk-rkqae7kh.js"), "checkCommand"),
-    dev: lazyCommand(commandMeta.dev, () => import("./chunk-vzy9rh6y.js"), "devCommand"),
-    doctor: lazyCommand(commandMeta.doctor, () => import("./chunk-enk76qd5.js"), "doctorCommand"),
-    eject: lazyCommand(commandMeta.eject, () => import("./chunk-br0n8n3e.js"), "ejectCommand"),
-    eval: lazyCommand(commandMeta.eval, () => import("./chunk-t5xx74rd.js"), "evalCommand"),
-    init: lazyCommand(commandMeta.init, () => import("./chunk-frk2wdq1.js"), "initCommand"),
-    "mcp-stdio": lazyCommand(commandMeta["mcp-stdio"], () => import("./chunk-m9bp2hc1.js"), "mcpStdioCommand"),
-    migrate: lazyCommand(commandMeta.migrate, () => import("./chunk-gprwej7h.js"), "migrateCommand"),
-    preview: lazyCommand(commandMeta.preview, () => import("./chunk-cn3dy3hz.js"), "previewCommand"),
-    skill: lazyCommand(commandMeta.skill, () => import("./chunk-dyk3r7jw.js"), "skillCommand"),
-    sync: lazyCommand(commandMeta.sync, () => import("./chunk-xgq4eytj.js"), "syncCommand"),
-    translate: lazyCommand(commandMeta.translate, () => import("./chunk-ahc5gc9h.js"), "translateCommand"),
-    upgrade: lazyCommand(commandMeta.upgrade, () => import("./chunk-7tekknev.js"), "upgradeCommand"),
-    validate: lazyCommand(commandMeta.validate, () => import("./chunk-dpcahcrb.js"), "validateCommand"),
-    version: lazyCommand(commandMeta.version, () => import("./chunk-mrvh4c88.js"), "versionCommand")
+    add: lazyCommand(commandMeta.add, () => import("./chunk-c5bjxq8v.js"), "addCommand"),
+    audit: lazyCommand(commandMeta.audit, () => import("./chunk-2ssh60qh.js"), "auditCommand"),
+    build: lazyCommand(commandMeta.build, () => import("./chunk-nqna8dzp.js"), "buildCommand"),
+    check: lazyCommand(commandMeta.check, () => import("./chunk-beb0z983.js"), "checkCommand"),
+    dev: lazyCommand(commandMeta.dev, () => import("./chunk-x60e15st.js"), "devCommand"),
+    doctor: lazyCommand(commandMeta.doctor, () => import("./chunk-hn3g2b89.js"), "doctorCommand"),
+    eject: lazyCommand(commandMeta.eject, () => import("./chunk-1ch3ct3r.js"), "ejectCommand"),
+    eval: lazyCommand(commandMeta.eval, () => import("./chunk-9jqmq5hv.js"), "evalCommand"),
+    init: lazyCommand(commandMeta.init, () => import("./chunk-etckvbrh.js"), "initCommand"),
+    "mcp-stdio": lazyCommand(commandMeta["mcp-stdio"], () => import("./chunk-qcyxkj44.js"), "mcpStdioCommand"),
+    migrate: lazyCommand(commandMeta.migrate, () => import("./chunk-yg8ckc3g.js"), "migrateCommand"),
+    preview: lazyCommand(commandMeta.preview, () => import("./chunk-69rjf786.js"), "previewCommand"),
+    skill: lazyCommand(commandMeta.skill, () => import("./chunk-p834rkcn.js"), "skillCommand"),
+    sync: lazyCommand(commandMeta.sync, () => import("./chunk-080mfch6.js"), "syncCommand"),
+    translate: lazyCommand(commandMeta.translate, () => import("./chunk-f260jdrn.js"), "translateCommand"),
+    upgrade: lazyCommand(commandMeta.upgrade, () => import("./chunk-ydqzkhjn.js"), "upgradeCommand"),
+    validate: lazyCommand(commandMeta.validate, () => import("./chunk-ppa6mg4d.js"), "validateCommand"),
+    version: lazyCommand(commandMeta.version, () => import("./chunk-x7bh6d9j.js"), "versionCommand")
   }
 });
 loadEnvFiles(process.cwd());

package/dist/types/core/config-input.d.ts

@@ -13,7 +13,7 @@ import type { AnySearchAdapter } from "../search/adapters/registry.ts";
 import type { SourceAdapterInput } from "../sources/registry.ts";
 import type { FontSlug } from "../theme/fonts.ts";
 import type { FooterSocial } from "./footer.ts";
-import type { OpenInChatProvider, SidebarDisplay, SidebarItemConfig } from "./schema.ts";
+import type { McpClient, McpCustomClient, OpenInChatProvider, SidebarDisplay, SidebarItemConfig } from "./schema.ts";
 import type { StandardSchema } from "./standard-schema.ts";
 /**
  * The public, hand-documented authoring type for `blume.config.ts`.
@@ -115,9 +115,15 @@ export interface FooterLink {
 }
 /**
  * The site footer, below the content on every page: a row of links on one
- * side, and social profile icons on the other.
+ * side, social profile icons on the other, and a copyright line centered
+ * between them.
  */
 export interface FooterConfig {
+    /**
+     * A line of plain text centered between the links and the icons, like
+     * `© 2026 Acme, Inc.`, or a map of locale code to text.
+     */
+    copyright?: LocalizableLabel;
     /** Links in one row, left to right. */
     links?: FooterLink[];
     /**
@@ -638,6 +644,32 @@ export interface LlmsTxtConfig {
 }
 /** Expose the docs as an MCP server for connecting agents. */
 export interface McpConfig {
+    /**
+     * The clients the "Connect to MCP" page action installs the server into,
+     * beside its "Copy server URL" row. Defaults to `true` (every built-in
+     * client). Set `false` to list none, or list built-in keys and your own
+     * clients, in order. A custom client's `command` is copied with `{name}`
+     * (the server name as an id) and `{url}` (the server's URL) filled in; its
+     * `label` localizes like a header link's, and `icon` defaults to `terminal`.
+     *
+     * ```ts
+     * agents: {
+     *   mcp: {
+     *     enabled: true,
+     *     clients: [
+     *       "claude-code",
+     *       {
+     *         label: "Copy Copilot CLI command",
+     *         command: "copilot mcp add --transport http {name} {url}",
+     *         icon: "terminal",
+     *       },
+     *       "vscode",
+     *     ],
+     *   },
+     * }
+     * ```
+     */
+    clients?: boolean | (McpClient | McpCustomClient)[];
     /** Turn the MCP server on. Defaults to `false`. */
     enabled?: boolean;
     /** Optional system hint passed to connecting agents. */
@@ -1408,8 +1440,8 @@ export interface BlumeConfig {
      */
     feedback?: boolean | FeedbackConfig;
     /**
-     * The site footer: social profile icons and up to four link columns. Unset,
-     * the site has no footer.
+     * The site footer: a copyright line, a row of links, and social profile
+     * icons. Unset, the site has no footer.
      */
     footer?: FooterConfig;
     /** Opt-in custom frontmatter keys, validated by schemas you supply. */
@@ -1438,7 +1470,7 @@ export interface BlumeConfig {
      * Limit how often one reader (by IP address) can call the server routes —
      * the assistant, the API playground proxy, server-side search — with an
      * adapter from `blume/ratelimit`: `memory()` (the default, 30 requests per
-     * 10 minutes), `upstash()`, or `cloudflare()`. `false` turns it off.
+     * 10 minutes), `upstash()`, `cloudflare()`, or `unkey()`. `false` turns it off.
      */
     rateLimit?: false | RateLimitAdapter;
     /** React island behavior (compiler auto-memoization). */

package/dist/types/core/data.d.ts

@@ -193,7 +193,7 @@ export interface BlumeDataConfig {
     feedback: boolean;
     /** Whether the rating asks for a written comment after it (`feedback.comments`). */
     feedbackComments: boolean;
-    /** `footer`: social profile icons and link columns, or `null` when unset. */
+    /** `footer`: the copyright line, links, and social profile icons, or `null` when unset. */
     footer: ResolvedConfig["footer"] | null;
     /**
      * Repo coordinates for content components that address the API or build
@@ -217,8 +217,12 @@ export interface BlumeDataConfig {
     /** `markdown.imageZoom`: click-to-zoom content images. */
     imageZoom: boolean;
     logo: BlumeLogo | null;
-    /** Hosted MCP server, or `null` when MCP is off. */
+    /**
+     * Hosted MCP server, or `null` when MCP is off, with the clients its
+     * "Connect to MCP" page action lists (`agents.mcp.clients`), in order.
+     */
     mcp: {
+        clients: ResolvedConfig["agents"]["mcp"]["clients"];
         name: string;
         route: string;
     } | null;

package/dist/types/core/mcp-clients.d.ts

@@ -0,0 +1,47 @@
+import type { LocalizableLabel } from "./schema.ts";
+/**
+ * Clients the "Connect to MCP" page action knows how to install the server
+ * into, in display order. Shared by the config schema (`agents.mcp.clients`
+ * entries validate against this list) and the PageActions menu (which renders
+ * the full list when the config is `true`). Lives outside `schema.ts` so the
+ * component can import the list without pulling the whole config schema into
+ * the layout module graph.
+ */
+export declare const mcpClients: readonly ["claude-code", "codex", "cursor", "vscode"];
+export type McpClient = (typeof mcpClients)[number];
+/** A client Blume doesn't ship: a menu row that copies its `command`. */
+export interface McpCustomClient {
+    /**
+     * Command the row copies, with `{name}` (the server name as an id, like
+     * `acme-docs`) and `{url}` (the server's absolute URL) filled in.
+     */
+    command: string;
+    /** Icon beside the label: a Lucide name, inline SVG, or image. Defaults to `terminal`. */
+    icon?: string;
+    /** Row label, optionally per locale (`{ en: "…", de: "…" }`). */
+    label: LocalizableLabel;
+}
+export type McpClientEntry = McpClient | McpCustomClient;
+/** A menu entry as a page renders it: a custom label resolved to its locale. */
+export type McpMenuEntry = McpClient | (Omit<McpCustomClient, "label"> & {
+    label: string;
+});
+/** Whether a `clients` entry names a built-in client rather than a custom one. */
+export declare const isBuiltInMcpClient: (client: McpClientEntry | McpMenuEntry) => client is McpClient;
+/** Resolve the custom clients' labels for one page's locale. */
+export declare const mcpMenuEntries: (clients: readonly McpClientEntry[], locale?: string, defaultLocale?: string) => McpMenuEntry[];
+/**
+ * The menu's rows after "Copy server URL", each with whether a rule goes
+ * above it: wherever the list switches between commands to copy and install
+ * links ("Copy server URL" copies too), so the default menu keeps its one
+ * rule before Cursor.
+ */
+export declare const mcpMenuRows: (entries: readonly McpMenuEntry[]) => {
+    client: McpMenuEntry;
+    rule: boolean;
+}[];
+/** Fill a custom client's command for the server it installs. */
+export declare const mcpClientCommand: (command: string, server: {
+    name: string;
+    url: string;
+}) => string;

package/dist/types/core/nav-diagnostics.d.ts

@@ -1,3 +1,4 @@
+import type { McpClientEntry } from "./mcp-clients.ts";
 import type { SidebarItemConfig } from "./schema.ts";
 import type { Diagnostic, Navigation, PageRecord } from "./types.ts";
 /** Warn about icon names that aren't in Blume's set (skipping image/SVG icons). */
@@ -10,6 +11,12 @@ export declare const validateSearchPopularIcons: (popular: {
     icon?: string;
     label: string;
 }[]) => Diagnostic[];
+/**
+ * Warn about unknown icons on custom "Connect to MCP" clients
+ * (`agents.mcp.clients`), which live outside the navigation model too. A
+ * per-locale label is named in the default locale.
+ */
+export declare const validateMcpClientIcons: (clients: readonly McpClientEntry[], defaultLocale?: string) => Diagnostic[];
 /**
  * Warn when a config-linked tab/selector target has no matching page. `routes`
  * must be the full set of servable routes — content, custom `.astro` pages, and

package/dist/types/core/schema.d.ts

@@ -994,19 +994,21 @@ declare const aiConfigSchema: z.ZodObject<{
         tools: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>;
     openInChat: z.ZodPipe<z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodArray<z.ZodEnum<{
+        cursor: "cursor";
         v0: "v0";
         chatgpt: "chatgpt";
         claude: "claude";
         t3: "t3";
         scira: "scira";
-        cursor: "cursor";
-    }>>]>>, z.ZodTransform<("v0" | "chatgpt" | "claude" | "t3" | "scira" | "cursor")[], boolean | ("v0" | "chatgpt" | "claude" | "t3" | "scira" | "cursor")[]>>;
+    }>>]>>, z.ZodTransform<("cursor" | "v0" | "chatgpt" | "claude" | "t3" | "scira")[], boolean | ("cursor" | "v0" | "chatgpt" | "claude" | "t3" | "scira")[]>>;
 }, z.core.$strict>;
 export { assistantReasoningLevels } from "../ai/ask.ts";
 export type { AssistantReasoning } from "../ai/ask.ts";
 export type AssistantConfig = NonNullable<z.infer<typeof aiConfigSchema>["assistant"]>;
 export { openInChatProviders } from "./open-in-chat.ts";
 export type { OpenInChatProvider } from "./open-in-chat.ts";
+export { mcpClients } from "./mcp-clients.ts";
+export type { McpClient, McpCustomClient } from "./mcp-clients.ts";
 /** A configured locale: ISO-ish code plus display metadata for the switcher. */
 declare const localeSchema: z.ZodObject<{
     code: z.ZodString;
@@ -1206,6 +1208,24 @@ export declare const blumeConfigSchema: z.ZodObject<{
         }>>;
         markdownComponents: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodCustom<ComponentMarkdown, ComponentMarkdown>>>;
         mcp: z.ZodPrefault<z.ZodObject<{
+            clients: z.ZodPipe<z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<{
+                "claude-code": "claude-code";
+                codex: "codex";
+                cursor: "cursor";
+                vscode: "vscode";
+            }>, z.ZodObject<{
+                command: z.ZodString;
+                icon: z.ZodOptional<z.ZodString>;
+                label: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
+            }, z.core.$strict>]>>]>>, z.ZodTransform<("claude-code" | "codex" | "cursor" | "vscode" | {
+                command: string;
+                label: string | Record<string, string>;
+                icon?: string | undefined;
+            })[], boolean | ("claude-code" | "codex" | "cursor" | "vscode" | {
+                command: string;
+                label: string | Record<string, string>;
+                icon?: string | undefined;
+            })[]>>;
             enabled: z.ZodDefault<z.ZodBoolean>;
             instructions: z.ZodOptional<z.ZodString>;
             name: z.ZodOptional<z.ZodString>;
@@ -1393,13 +1413,13 @@ export declare const blumeConfigSchema: z.ZodObject<{
             tools: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>;
         openInChat: z.ZodPipe<z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodArray<z.ZodEnum<{
+            cursor: "cursor";
             v0: "v0";
             chatgpt: "chatgpt";
             claude: "claude";
             t3: "t3";
             scira: "scira";
-            cursor: "cursor";
-        }>>]>>, z.ZodTransform<("v0" | "chatgpt" | "claude" | "t3" | "scira" | "cursor")[], boolean | ("v0" | "chatgpt" | "claude" | "t3" | "scira" | "cursor")[]>>;
+        }>>]>>, z.ZodTransform<("cursor" | "v0" | "chatgpt" | "claude" | "t3" | "scira")[], boolean | ("cursor" | "v0" | "chatgpt" | "claude" | "t3" | "scira")[]>>;
     }, z.core.$strict>>;
     analytics: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"adobe">;
@@ -3038,6 +3058,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
         enabled: boolean;
     }>>>;
     footer: z.ZodOptional<z.ZodObject<{
+        copyright: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
         links: z.ZodDefault<z.ZodArray<z.ZodObject<{
             href: z.ZodString;
             label: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
@@ -3350,6 +3371,16 @@ export declare const blumeConfigSchema: z.ZodObject<{
         }, z.core.$strict>;
         requiredSecrets: z.ZodArray<z.ZodString>;
         runtimeDeps: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"unkey">;
+        options: z.ZodObject<{
+            requests: z.ZodOptional<z.ZodNumber>;
+            namespace: z.ZodOptional<z.ZodString>;
+            rootKeyEnv: z.ZodOptional<z.ZodString>;
+            window: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>;
+        requiredSecrets: z.ZodArray<z.ZodString>;
+        runtimeDeps: z.ZodArray<z.ZodString>;
     }, z.core.$strict>], "kind">]>>, z.ZodTransform<{
         kind: "cloudflare";
         options: {
@@ -3377,6 +3408,16 @@ export declare const blumeConfigSchema: z.ZodObject<{
         };
         requiredSecrets: string[];
         runtimeDeps: string[];
+    } | {
+        kind: "unkey";
+        options: {
+            requests?: number | undefined;
+            namespace?: string | undefined;
+            rootKeyEnv?: string | undefined;
+            window?: number | undefined;
+        };
+        requiredSecrets: string[];
+        runtimeDeps: string[];
     } | null, false | {
         kind: "cloudflare";
         options: {
@@ -3404,6 +3445,16 @@ export declare const blumeConfigSchema: z.ZodObject<{
         };
         requiredSecrets: string[];
         runtimeDeps: string[];
+    } | {
+        kind: "unkey";
+        options: {
+            requests?: number | undefined;
+            namespace?: string | undefined;
+            rootKeyEnv?: string | undefined;
+            window?: number | undefined;
+        };
+        requiredSecrets: string[];
+        runtimeDeps: string[];
     } | undefined>>;
     react: z.ZodPrefault<z.ZodObject<{
         compiler: z.ZodDefault<z.ZodBoolean>;

package/dist/types/ratelimit/index.d.ts

@@ -25,3 +25,5 @@ export type { MemoryAdapter, RateLimitOptions } from "./memory.ts";
 export type { RateLimitAdapter } from "./schema.ts";
 export { upstash } from "./upstash.ts";
 export type { UpstashAdapter, UpstashOptions } from "./upstash.ts";
+export { unkey } from "./unkey.ts";
+export type { UnkeyAdapter, UnkeyOptions } from "./unkey.ts";

package/dist/types/ratelimit/memory.d.ts

@@ -31,6 +31,6 @@ export declare const memoryAdapterSchema: z.ZodObject<{
  * platform that runs many short-lived instances (Vercel, Netlify,
  * Cloudflare) each instance keeps its own, so it stops a burst from one
  * reader rather than enforcing the limit exactly. For that, share the count
- * with `upstash()` or `cloudflare()`.
+ * with `upstash()`, `cloudflare()`, or `unkey()`.
  */
 export declare const memory: (options?: RateLimitOptions) => MemoryAdapter;

package/dist/types/ratelimit/schema.d.ts

@@ -27,6 +27,16 @@ export declare const rateLimitAdapterSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
     }, z.core.$strict>;
     requiredSecrets: z.ZodArray<z.ZodString>;
     runtimeDeps: z.ZodArray<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"unkey">;
+    options: z.ZodObject<{
+        requests: z.ZodOptional<z.ZodNumber>;
+        namespace: z.ZodOptional<z.ZodString>;
+        rootKeyEnv: z.ZodOptional<z.ZodString>;
+        window: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>;
+    requiredSecrets: z.ZodArray<z.ZodString>;
+    runtimeDeps: z.ZodArray<z.ZodString>;
 }, z.core.$strict>], "kind">;
 export type RateLimitAdapter = z.output<typeof rateLimitAdapterSchema>;
 /**
@@ -62,6 +72,16 @@ export declare const rateLimitConfigSchema: z.ZodPipe<z.ZodOptional<z.ZodUnion<r
     }, z.core.$strict>;
     requiredSecrets: z.ZodArray<z.ZodString>;
     runtimeDeps: z.ZodArray<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"unkey">;
+    options: z.ZodObject<{
+        requests: z.ZodOptional<z.ZodNumber>;
+        namespace: z.ZodOptional<z.ZodString>;
+        rootKeyEnv: z.ZodOptional<z.ZodString>;
+        window: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>;
+    requiredSecrets: z.ZodArray<z.ZodString>;
+    runtimeDeps: z.ZodArray<z.ZodString>;
 }, z.core.$strict>], "kind">]>>, z.ZodTransform<{
     kind: "cloudflare";
     options: {
@@ -89,6 +109,16 @@ export declare const rateLimitConfigSchema: z.ZodPipe<z.ZodOptional<z.ZodUnion<r
     };
     requiredSecrets: string[];
     runtimeDeps: string[];
+} | {
+    kind: "unkey";
+    options: {
+        requests?: number | undefined;
+        namespace?: string | undefined;
+        rootKeyEnv?: string | undefined;
+        window?: number | undefined;
+    };
+    requiredSecrets: string[];
+    runtimeDeps: string[];
 } | null, false | {
     kind: "cloudflare";
     options: {
@@ -116,4 +146,14 @@ export declare const rateLimitConfigSchema: z.ZodPipe<z.ZodOptional<z.ZodUnion<r
     };
     requiredSecrets: string[];
     runtimeDeps: string[];
+} | {
+    kind: "unkey";
+    options: {
+        requests?: number | undefined;
+        namespace?: string | undefined;
+        rootKeyEnv?: string | undefined;
+        window?: number | undefined;
+    };
+    requiredSecrets: string[];
+    runtimeDeps: string[];
 } | undefined>>;

package/dist/types/ratelimit/unkey.d.ts

@@ -0,0 +1,48 @@
+import { z } from "zod";
+import type { AdapterDescriptor } from "../core/adapter.ts";
+import type { RateLimitOptions } from "./memory.ts";
+/** The Unkey rate limit namespace the count is kept in, unless set. */
+export declare const UNKEY_NAMESPACE = "docs";
+/** The longest window Unkey takes, in seconds (30 days). */
+export declare const UNKEY_MAX_WINDOW = 2592000;
+/** Options for {@link unkey}. */
+export interface UnkeyOptions extends RateLimitOptions {
+    /**
+     * The Unkey rate limit namespace, up to 512 characters. Defaults to `docs`;
+     * Unkey creates it on the first request.
+     */
+    namespace?: string;
+    /** Name of the env var holding the root key. Defaults to `UNKEY_ROOT_KEY`. */
+    rootKeyEnv?: string;
+    /** The window, in seconds: Unkey takes up to 30 days. */
+    window?: number;
+}
+export declare const unkeyOptionsSchema: z.ZodObject<{
+    requests: z.ZodOptional<z.ZodNumber>;
+    namespace: z.ZodOptional<z.ZodString>;
+    rootKeyEnv: z.ZodOptional<z.ZodString>;
+    window: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type UnkeyAdapter = AdapterDescriptor<"unkey", UnkeyOptions>;
+export declare const unkeyAdapterSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"unkey">;
+    options: z.ZodObject<{
+        requests: z.ZodOptional<z.ZodNumber>;
+        namespace: z.ZodOptional<z.ZodString>;
+        rootKeyEnv: z.ZodOptional<z.ZodString>;
+        window: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>;
+    requiredSecrets: z.ZodArray<z.ZodString>;
+    runtimeDeps: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+/** The env var the root key is read from. */
+export declare const unkeySecrets: (options: UnkeyOptions) => [string];
+/**
+ * Counts with Unkey's rate limiting, which every instance on every host
+ * shares. Unkey counts in each region and shares the counts between them
+ * within moments, so a short burst split across regions can pass more than
+ * the limit. It talks to Unkey's REST API, so there is nothing to install;
+ * the root key comes from `UNKEY_ROOT_KEY`, or the env var `rootKeyEnv`
+ * names.
+ */
+export declare const unkey: (options?: UnkeyOptions) => UnkeyAdapter;

package/docs/02-deployment.mdx

@@ -267,6 +267,7 @@ When a feature needs a secret, Blume warns at `blume dev`/`build` if it's missin
 | Assistant (other adapters) | the adapter's default key env var (`OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, `GEMINI_API_KEY`, `XAI_API_KEY`, `OPENROUTER_API_KEY`, `LLMGATEWAY_API_KEY`, `INKEEP_API_KEY`), or the `apiKeyEnv` you passed it |
 | [Assistant bot protection](/docs/configuration/assistant#bot-protection) | `TURNSTILE_SECRET_KEY` (`turnstile()`), `HCAPTCHA_SECRET_KEY` (`hcaptcha()`) |
 | [Rate limiting](/docs/configuration/rate-limiting) (`upstash()`) | `UPSTASH_REDIS_REST_URL` and `UPSTASH_REDIS_REST_TOKEN` |
+| [Rate limiting](/docs/configuration/rate-limiting) (`unkey()`) | `UNKEY_ROOT_KEY`, or the `rootKeyEnv` you passed it |
 | Mixedbread search | `MIXEDBREAD_API_KEY` |
 | [Narration](/docs/configuration/narration) (generated voices) | `AI_GATEWAY_API_KEY` (or Vercel OIDC) for `gateway()`, `OPENAI_API_KEY` for `openai()` (none with a `baseUrl`, unless you name one), or the `apiKeyEnv` you passed to either |
 | [Content sources](/docs/content/sources) | `NOTION_TOKEN` (`notion()`), `SANITY_TOKEN` (`sanity()`), `CONTENTFUL_ACCESS_TOKEN` (`contentful()`, plus `CONTENTFUL_PREVIEW_TOKEN` for `--preview`, which fails without it), `PAYLOAD_API_KEY` (`payload()`), `STRAPI_API_TOKEN` (`strapi()`), `GITHUB_TOKEN` (`githubReleases()`, and `mdxRemote()` with `github`) |

package/docs/configuration/index.mdx

@@ -101,7 +101,7 @@ export default defineConfig({
 | `description` | — | Default meta description, used for SEO and OG. |
 | `logo` | — | Brand mark and/or wordmark shown in the header. |
 | `banner` | — | Site-wide announcement bar above the header. |
-| `footer` | — | A row of links and social profile icons below the content. |
+| `footer` | — | A copyright line, a row of links, and social profile icons below the content. |
 
 ### Logo
 
@@ -204,10 +204,11 @@ A translated banner keys dismissal on the default locale's text, so one dismissa
 
 ### Footer
 
-Every page ends with a footer: one row, as tall as the header, with your links on one side and social profile icons on the other. The footer is the only place Blume links your social profiles and repository, so the [`github`](#github) repository comes first among the icons whenever it's set. `footer` adds the rest:
+Every page ends with a footer: one row, as tall as the header, with your links on one side, social profile icons on the other, and a copyright line centered between them. The footer is the only place Blume links your social profiles and repository, so the [`github`](#github) repository comes first among the icons whenever it's set. `footer` adds the rest:
 
 ```ts blume.config.ts lineNumbers
 footer: {
+  copyright: "© 2026 Acme, Inc.",
   links: [
     { label: "Pricing", href: "https://acme.dev/pricing" },
     { label: "Changelog", href: "/changelog" },
@@ -220,9 +221,9 @@ footer: {
 },
 ```
 
-`links` appear in the order you write them. Write internal links as if mounted at root; an external link opens in a new tab. On a [multilingual](/docs/content/i18n#per-locale-navigation) site, a `label` can be a map of locale code to text, and an internal link moves into the reader's locale whenever that locale serves the page. `socials` maps a platform to its profile URL, and the icons appear in the order you write them. The platforms are `bluesky`, `discord`, `facebook`, `github`, `hacker-news`, `instagram`, `linkedin`, `medium`, `podcast`, `reddit`, `slack`, `telegram`, `threads`, `website`, `x`, and `youtube`. A `github` social replaces the repository link; hide that link with [`navigation.repo`](/docs/content/navigation#repository-link).
+`copyright` is plain text, so write `©` itself rather than `©`. For a year that keeps itself current, use a template literal: `` `© ${new Date().getFullYear()} Acme, Inc.` ``. `links` appear in the order you write them. Write internal links as if mounted at root; an external link opens in a new tab. On a [multilingual](/docs/content/i18n#per-locale-navigation) site, `copyright` and a `label` can each be a map of locale code to text, and an internal link moves into the reader's locale whenever that locale serves the page. `socials` maps a platform to its profile URL, and the icons appear in the order you write them. The platforms are `bluesky`, `discord`, `facebook`, `github`, `hacker-news`, `instagram`, `linkedin`, `medium`, `podcast`, `reddit`, `slack`, `telegram`, `threads`, `website`, `x`, and `youtube`. A `github` social replaces the repository link; hide that link with [`navigation.repo`](/docs/content/navigation#repository-link).
 
-A site with no links, profiles, or repository has no footer. Custom pages built on `PageLayout` show it too, unless they fill the layout's own `footer` slot. To replace it entirely, override the [`Footer` layout slot](/docs/configuration/customization#layout-slots).
+A site with no copyright, links, profiles, or repository has no footer. Custom pages built on `PageLayout` show it too, unless they fill the layout's own `footer` slot. To replace it entirely, override the [`Footer` layout slot](/docs/configuration/customization#layout-slots).
 
 ## Content
 

package/docs/configuration/rate-limiting.mdx

@@ -1,6 +1,6 @@
 ---
 title: Rate limiting
-description: Limit how often one reader can call the assistant, the API playground proxy, and server-side search, on by default, with the count kept in memory, Upstash, or Cloudflare.
+description: Limit how often one reader can call the assistant, the API playground proxy, and server-side search, on by default, with the count kept in memory, Upstash, Cloudflare, or Unkey.
 ---
 
 The server routes a reader can call cost you something each time: the [assistant](/docs/configuration/assistant) spends model tokens, the [API playground](/docs/references/openapi#cors-and-the-proxy) proxy relays requests to your API, and [Mixedbread search](/docs/configuration/search#mixedbread) runs a paid query. Blume limits how often one reader, identified by IP address, can call each of them. A reader over the limit gets `429 Too Many Requests` with a `Retry-After` header, and the assistant tells them to try again in a few minutes.
@@ -25,6 +25,7 @@ Each route keeps its own count, so a busy playground session doesn't use up the
 | `memory()` | The server's memory (the default) | Exactly on one server; per instance on serverless hosts |
 | `upstash()` | [Upstash Redis](https://upstash.com) | Exactly, on every host |
 | `cloudflare()` | Cloudflare's Workers rate limiting | Per Cloudflare location |
+| `unkey()` | [Unkey](https://unkey.com) | On every host; regions catch up within moments |
 
 ### Memory
 
@@ -68,6 +69,24 @@ export default defineConfig({
 
 The binding's namespace comes from the Worker's name, so two sites on one account don't share a count. Set `namespaceId` to choose it yourself.
 
+### Unkey
+
+`unkey()` keeps the count in [Unkey's rate limiting](https://www.unkey.com/docs/api-management/ratelimiting/overview), which every instance shares. Create a root key with the `ratelimit.*.limit` permission, plus `ratelimit.*.create_namespace` so Unkey can create the namespace on the first request, then set it as `UNKEY_ROOT_KEY`. Blume talks to Unkey's REST API, so there's nothing to install. Until the key is set, the routes count in memory and `blume build` warns.
+
+```ts blume.config.ts lineNumbers
+import { unkey } from "blume/ratelimit";
+
+rateLimit: unkey(),
+```
+
+The namespace is `docs` unless you name another with `namespace`. Name the variable that holds the key with `rootKeyEnv`:
+
+```ts blume.config.ts lineNumbers
+rateLimit: unkey({ namespace: "acme-docs", rootKeyEnv: "DOCS_UNKEY_ROOT_KEY" }),
+```
+
+Unkey counts in each region and shares the counts between regions within moments, so a short burst split across regions can get a few more requests through than the limit. Every count fails with a key Unkey refuses, like one missing those permissions, and a request a shared store fails to count is let through, so if the server logs `Rate limiting failed`, check the key.
+
 ## Behind a reverse proxy
 
 Vercel, Netlify, and Cloudflare tell Blume each reader's address. A `node()` server behind a reverse proxy, like nginx or Caddy, sees every request come from the proxy, so every reader shares one count and a busy site hits the limit for everyone. List the host the proxy answers for in `allowedDomains`:

package/docs/content/i18n.mdx

@@ -85,7 +85,7 @@ i18n: {
 
 Each language gets its own sidebar, built from that locale's files — so translations can diverge in structure, ordering, or labels. Folder [`meta.ts`](/docs/content/meta) files resolve per locale, too: under the default `dir` parser, put a `meta.ts` under `fr/guides/` to order the French group independently. Until a locale has one (or a shared `meta.$.ts`), its group mirrors the [fallback](#fallbacks) locale's — that folder's `meta.ts` and the `sidebar.display` its index page sets — so pages that fall back keep the same titles, order, and collapsible groups. Under the `dot` parser translations sit next to the originals, so a folder's `meta.ts` applies to every locale. Everything else about [navigation](/docs/content/navigation) works the same, per language.
 
-Header tabs, header links, and the footer are configured, not derived from content, so their labels localize in `blume.config.ts`. Every configured label accepts a per-locale map (`{ en: "Docs", fr: "Documentation" }`) alongside the plain-string form, falling back to the default locale's entry for locales you haven't filled in: tab and dropdown labels ([Tabs](/docs/content/navigation#tabs)), [featured links](/docs/content/navigation#featured-links), [header actions](/docs/content/navigation#header-actions) and the call to action, [footer](/docs/configuration#footer) links, and the [banner](/docs/configuration#banner)'s text and link text.
+Header tabs, header links, and the footer are configured, not derived from content, so their labels localize in `blume.config.ts`. Every configured label accepts a per-locale map (`{ en: "Docs", fr: "Documentation" }`) alongside the plain-string form, falling back to the default locale's entry for locales you haven't filled in: tab and dropdown labels ([Tabs](/docs/content/navigation#tabs)), [featured links](/docs/content/navigation#featured-links), [header actions](/docs/content/navigation#header-actions) and the call to action, [footer](/docs/configuration#footer) links, the [banner](/docs/configuration#banner)'s text and link text, and custom clients in the [Connect to MCP](/docs/discoverability/mcp#connect-to-mcp-menu) menu.
 
 ```ts blume.config.ts lineNumbers
 navigation: {