docmd provides a set of professionally designed, light/dark responsive themes. You can switch your entire site’s aesthetic by changing a single key in docmd.config.js.

How to Switch Themes

// docmd.config.js
module.exports = {
  theme: {
    name: 'sky',
    appearance: 'system', // Options: 'light', 'dark', 'system'
  }
}

Built-in Theme Gallery

1. sky (Default)

The gold standard for modern documentation. It features crisp typography, subtle transitions, and high-contrast light/dark modes that match modern SaaS platforms.

2. ruby

A high-elegance theme using serif typography for headers and a deep, jewel-toned color palette. Perfect for documentation that needs to feel authoritative and premium.

3. retro

A nostalgia-fueled theme inspired by vintage computing. Features include phosphor-green text on black backgrounds (in dark mode), scanline effects, and monospace fonts like Fira Code by default.

4. default

A total “Blank Slate” theme. Use this if you plan on adding extensive custom CSS and don’t want any built-in design layers interfering with your branding.

Theming Architecture

1. CSS Layering: Themes are additive. Choosing sky actually loads the base default styles and then overlays the sky aesthetic on top.
2. Native dark-mode: Every theme includes a first-class dark mode implementation.
3. No Refresh: When users switch themes via the UI, the SPA engine updates the --docmd-primary variables instantly without a page reload.