Configuration file

Every option in blume.config.ts — site metadata, content, and links to each feature guide.

Blume reads blume.config.ts from your project root. Wrap your config in defineConfig for autocomplete and type-checking — every field is optional, with a sensible default.

import { defineConfig } from "blume";

export default defineConfig({
  title: "My Docs",
  description: "Documentation for my project.",
});

A complete example

A broader example touching the most common options (see each feature’s guide for the rest):

import { defineConfig } from "blume";

export default defineConfig({
  // Site
  title: "My Docs",
  description: "Documentation for my project.",
  logo: "/logo.svg",

  // Content
  content: {
    root: "docs",
  },

  // Theme — see the Theming guide
  theme: {
    accent: "teal",
    radius: "md",
    mode: "system",
  },

  // Search — see the Search guide
  search: {
    provider: "orama",
  },

  // Markdown features
  markdown: {
    imageZoom: true,
    code: {
      icons: true, // language icon in the code-block header
      wrap: false, // wrap long lines instead of scrolling
    },
    codeBlocks: {
      theme: {
        light: "github-light", // any bundled Shiki theme
        dark: "github-dark",
      },
    },
  },

  // AI — see the AI guide
  ai: {
    llmsTxt: true,
  },

  // MCP server (needs server output) — see the AI guide
  mcp: {
    enabled: false,
    route: "/mcp",
  },

  // SEO — OG images, feeds, sitemap, structured data; see the SEO guide
  seo: {
    og: { enabled: true },
    rss: { enabled: true, types: ["blog", "changelog"] },
    sitemap: true,
    robots: true,
    structuredData: true,
  },

  // Deployment — see the Deployment guide
  deployment: {
    output: "static",
    site: "https://docs.example.com",
  },
});

Site

Logo

Point logo at an SVG and Blume inlines it, so a currentColor logo follows the light and dark theme automatically:

logo: "/logo.svg",

The SVG can live at your project root or in public/. The brand is a mark (image) plus a wordmark (text); the object form lets you set them independently:

logo: {
  image: "/logo.svg", // string, or { light, dark, alt } for themed raster art
  text: "Acme",       // wordmark beside the mark
  href: "/",          // overrides the brand link (defaults to "/")
},

image takes the same value as the shorthand — a single path, or { light, dark, alt } for separate light/dark artwork (raster images must live in public/).

text controls the wordmark independently of the mark:

• Omit text and the brand uses your site title (the default).
• Set text: "" to show the mark alone — handy when the logo image already includes the wordmark.
• Set text with no image for a text-only logo.

Favicon

There’s no favicon option — Blume auto-detects one by filename, the way Next.js does. Drop an icon or favicon file (.svg, .png, or .ico) in your project root or public/ directory and it becomes the browser tab icon:

my-docs/
├─ blume.config.ts
├─ icon.png          ← picked up automatically
└─ docs/

SVG wins over PNG over ICO when several are present, and a file in public/ is preferred over one at the root. If Blume finds no icon, it falls back to its own mark.

Apple touch icon

The icon iOS uses when someone adds your site to their home screen is detected the same way. Drop an apple-icon file (.png, .jpg, or .jpeg) — or an apple-touch-icon.png, the name most favicon generators emit — in your project root or public/ directory and Blume wires up <link rel="apple-touch-icon"> for you. There’s no default; if no file is found, no tag is emitted.

my-docs/
├─ blume.config.ts
├─ apple-icon.png     ← picked up automatically
└─ docs/

Put the file in public/ rather than the project root: iOS ignores the inlined data URI Blume uses for a root-level icon, so only a public/ file (served at /apple-icon.png) reliably reaches the home screen.

Banner

Show a site-wide announcement bar above the header. Pass a string, or an object with a link and a dismiss button:

banner: "Docs are in beta — expect changes.",

banner: {
  content: "Blume v1 is here!",
  link: { text: "Read more", href: "/blog/v1" },
  dismissible: true,
  id: "v1",
},

When dismissible is on, the bar shows a close button and stays hidden for that visitor afterward. The dismissal key defaults to the content text, so editing the message brings the banner back; set a stable id to keep it dismissed across edits.

Content

Where your content lives and how Blume discovers it. See Pages for how files become routes.

content: {
  root: "docs",
}

Static assets live in public/ — a file at public/logo.png is served at /logo.png, so a reference like ![](/images/create.png) resolves against public/images/create.png.

Last modified

Show a “Last updated on …” line at the bottom of each page. Off by default; set lastModified to true to derive each page’s date from its git history:

lastModified: true,

The git source reads the most recent commit that touched each file, so it works in any git repository — including monorepos — and needs the repo’s history at build time (avoid a shallow --depth 1 checkout in CI). A page’s own lastModified frontmatter always wins, which is handy for pinning a date or for files that aren’t committed yet:

---
title: My page
lastModified: 2026-06-20
---

When enabled, the date is also emitted as schema.org dateModified in the page’s structured data.

SEO

Open Graph images, RSS feeds, and JSON-LD structured data, grouped under seo. See the SEO guide for metadata, frontmatter overrides, and the full reference.

seo: {
  og: { enabled: true },
  rss: { enabled: true, types: ["blog", "changelog"] },
  sitemap: true,
  robots: true,
  structuredData: true,
}

These work best with an absolute deployment.site for full URLs.

Table of contents

The on-this-page outline is on by default and lists H2–H3 headings. Turn it off, or change the heading range, with toc:

export default defineConfig({
  toc: false, // hide it everywhere
  // …or narrow the range:
  toc: { minHeadingLevel: 2, maxHeadingLevel: 4 },
});

Feature options

Each of these has its own guide. The config field is the entry point:

Precedence

Settings resolve from lowest to highest priority, so you only override what you need: