Agent-readable docs index: /llms.txt. Full docs in one file: /llms-full.txt. Download /docs.zip to grep all markdown files locally.

Theme

Holocron uses shadcn-compatible CSS variables. If you already have a shadcn theme, you can port it directly.

Primary color

Set a brand color in docs.json:
{
  "colors": {
    "primary": "#6366f1"
  }
}
You can also specify separate light and dark mode accent variants:
{
  "colors": {
    "primary": "#6366f1",
    "light": "#818cf8",
    "dark": "#4f46e5"
  }
}
Mintlify names these by the shade, not the mode: colors.dark is used in light mode, and colors.light is used in dark mode.

Appearance mode

Control the default color mode and whether users can toggle:
{
  "appearance": {
    "default": "system",
    "strict": false
  }
}
ValueBehavior
"system"Follow the user's OS setting (default)
"light"Force light mode
"dark"Force dark mode
strict: trueHide the mode toggle

CSS variable overrides

Holocron's tokens follow the shadcn naming convention. Override them in your own CSS file:
@reference "tailwindcss";
@custom-variant dark (&:where(.dark, .dark *));

:root {
  --background: #fafafa;
  --foreground: #0a0a0a;
  --primary: #6366f1;
  --muted-foreground: #737373;
  --border: #e5e5e5;

  @variant dark {
    --background: #0a0a0a;
    --foreground: #fafafa;
    --primary: #818cf8;
    --border: #262626;
  }
}
Use @variant dark instead of Tailwind's dark: for dark mode overrides. This keeps all theme values in CSS variables that adapt automatically. The @custom-variant dark line makes those overrides follow Holocron's persisted .dark class instead of the browser system media query.

Available tokens

Colors

Common color tokens include:
TokenPurpose
--background / --foregroundPage surface and default text
--card / --card-foregroundElevated surfaces
--primary / --primary-foregroundBrand color and text on it
--muted / --muted-foregroundMuted backgrounds and placeholder text
--accent / --accent-foregroundHover/active highlights
--borderDefault border color
--border-subtleLighter border for subtle dividers
--sidebar-foreground / --sidebar-primarySidebar text and active item

Typography

TokenDefaultPurpose
--type-body-size14pxBase body text size
--type-heading-1-size16pxH1 heading size
--type-heading-2-size16pxH2 heading size
--type-heading-3-size16pxH3 heading size
--type-small-size13pxSmall text
--type-nav-group-size12pxSidebar group labels
--weight-regular400Normal text weight
--weight-prose475Body prose weight
--weight-heading560Heading weight

Code blocks

Style fenced code blocks without targeting internal selectors:
TokenDefaultPurpose
--code-block-backgroundtransparentBackground color
--code-block-bordernoneBorder (e.g. 1px solid var(--border-subtle))
--code-block-shadownoneBox shadow around the frame
--code-block-radius0pxCorner radius
--code-block-padding-x0pxHorizontal padding
--code-block-padding-y0.5remVertical padding
The copy button automatically aligns to the top-right of the padded frame.
:root {
  --code-block-background: var(--muted);
  --code-block-border: 1px solid var(--border-subtle);
  --code-block-radius: var(--radius-md);
  --code-block-padding-x: 8px;
  --code-block-padding-y: 12px;
}

Blockquotes

TokenDefaultPurpose
--blockquote-border-width3pxLeft border thickness
--blockquote-border-colorvar(--border)Left border color
--blockquote-font-weightinheritFont weight (e.g. 500 for bolder quotes)

Cards

TokenDefaultPurpose
--card-padding16pxInner padding
--card-border1px solid var(--border-subtle)Border around the card frame
--card-shadownoneBox shadow around the card frame

Tables

TokenDefaultPurpose
--table-radius0pxCorner radius on markdown tables
TokenDefaultPurpose
--sidebar-group-margin-top12pxTop margin above group labels
--sidebar-link-radius0pxBorder radius on nav links
--sidebar-indent12pxIndentation per nesting level
--sidebar-active-backgroundtransparentBackground pill behind the deepest active item (TOC heading when expanded, else page link)
--sidebar-hover-backgroundvar(--accent)Hover background on sidebar links, group toggles, and TOC headings
--search-input-radiusvar(--radius-xl)Corner radius of the sidebar search input

Spacing

TokenDefaultPurpose
--prose-gap20pxBetween elements inside a section
--section-gap48pxBetween heading-delimited sections
--list-gap8pxBetween list items

Semantic colors

Holocron also defines semantic colors for callouts and badges: --blue, --green, --yellow, --orange, --red, --purple. These adapt to dark mode automatically.
Powered byHolocron