The docmd.config.js file serves as the definitive configuration for your documentation project. It controls site structure, branding, UI behaviour, and engine-level processing rules.

The Configuration File

We recommend using the defineConfig helper provided by @docmd/core. This provides full IDE autocomplete and type-checking, enabling effortless discovery of available settings.

import { defineConfig } from '@docmd/core';

export default defineConfig({
  title: 'My Project',
  url: 'https://docs.myproject.com',
  // ... configuration settings
});

Core Settings

docmd utilises a simple configuration schema. Below are the primary top-level settings:

Branding & Identity

Configure how your brand is represented in the navigation header and browser tabs.

logo: {
  light: 'assets/images/logo-dark.png',  // Logo shown in Light Mode
  dark: 'assets/images/logo-light.png',  // Logo shown in Dark Mode
  href: '/',                             // Link destination when clicking the logo
  alt: 'Company Logo',                   // Alternative text for accessibility
  height: '32px'                         // Optional: Explicit height for the logo
},
favicon: 'assets/favicon.ico',           // Path to your site's favicon

Site Layout & UI

docmd features a modular layout system. You can toggle UI components like the Sidebar, Header, Menubar, and Global Search via the layout object.

For a full breakdown of functional zones and configuration options, see Layout & UI Zones.

Core Engine Features

Fine-tune how docmd processes and renders your documentation content.

minify: true,           // Minifies production assets (CSS/JS) for better performance
autoTitleFromH1: true,  // Uses the first H1 heading as the page title if frontmatter 'title' is missing
copyCode: true,         // Adds a 'Copy' button to all code blocks automatically
pageNavigation: true,   // Adds 'Previous' and 'Next' navigation links at the bottom of pages

Legacy Support

If you are upgrading from an older version of docmd, the following keys are automatically mapped to the modern schema for backward compatibility:

• siteTitle → title
• siteUrl / baseUrl → url
• srcDir / source → src
• outDir / outputDir → out