@mintlify/prebuild
Version:
Helpful functions for Mintlify's prebuild step
1,058 lines • 116 kB
TypeScript
import { ConfigType } from '@mintlify/models';
export declare class ConfigUpdater<T> {
private type;
constructor(type: ConfigType);
getConfigType(): "mint" | "docs";
getConfig(configPath: string, strict?: boolean, onError?: (message: string) => void): Promise<T>;
validateConfigJsonString: (configContents: string, strict?: boolean, onError?: (message: string) => void) => Promise<{
data: T;
warnings: import("zod").ZodIssue[];
success: true;
error?: never;
} | {
data: T;
warnings: import("zod").ZodIssue[];
success: true;
error?: never;
}>;
private readConfigFile;
writeConfigFile: (config: T, targetDir?: string) => Promise<void>;
private parseConfigJson;
}
export declare const MintConfigUpdater: ConfigUpdater<import("@mintlify/models").MintConfigType>;
export declare const DocsConfigUpdater: ConfigUpdater<{
name: string;
$schema: string;
theme: "mint";
colors: {
primary: string;
light?: string | undefined;
dark?: string | undefined;
};
navigation: {
products: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").ProductNavigation<"default">[];
global?: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").GlobalNavigation | undefined;
} | {
languages: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").LanguageNavigation<"default">[];
global?: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").GlobalNavigation | undefined;
} | {
versions: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").VersionNavigation<"default">[];
global?: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").GlobalNavigation | undefined;
} | {
tabs: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").TabNavigation<"default">[];
global?: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").GlobalNavigation | undefined;
} | {
dropdowns: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").DropdownNavigation<"default">[];
global?: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").GlobalNavigation | undefined;
} | {
anchors: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").AnchorNavigation<"default">[];
global?: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").GlobalNavigation | undefined;
} | {
groups: ({
openapi: string | string[] | {
source: string;
directory?: string | undefined;
};
group: string;
pages: any[];
icon?: string | {
name: string;
style?: "brands" | "duotone" | "light" | "regular" | "sharp-duotone-solid" | "sharp-light" | "sharp-regular" | "sharp-solid" | "sharp-thin" | "solid" | "thin" | undefined;
library?: "fontawesome" | "lucide" | undefined;
} | undefined;
expanded?: boolean | undefined;
public?: boolean | undefined;
tag?: string | undefined;
hidden?: boolean | undefined;
root?: string | undefined;
} | {
group: string;
pages: any[];
asyncapi: string | string[] | {
source: string;
directory?: string | undefined;
};
icon?: string | {
name: string;
style?: "brands" | "duotone" | "light" | "regular" | "sharp-duotone-solid" | "sharp-light" | "sharp-regular" | "sharp-solid" | "sharp-thin" | "solid" | "thin" | undefined;
library?: "fontawesome" | "lucide" | undefined;
} | undefined;
expanded?: boolean | undefined;
public?: boolean | undefined;
tag?: string | undefined;
hidden?: boolean | undefined;
root?: string | undefined;
} | {
group: string;
pages: any[];
icon?: string | {
name: string;
style?: "brands" | "duotone" | "light" | "regular" | "sharp-duotone-solid" | "sharp-light" | "sharp-regular" | "sharp-solid" | "sharp-thin" | "solid" | "thin" | undefined;
library?: "fontawesome" | "lucide" | undefined;
} | undefined;
expanded?: boolean | undefined;
public?: boolean | undefined;
tag?: string | undefined;
hidden?: boolean | undefined;
root?: string | undefined;
})[];
global?: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").GlobalNavigation | undefined;
} | {
pages: any[];
global?: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").GlobalNavigation | undefined;
};
background?: {
color?: {
light?: string | undefined;
dark?: string | undefined;
} | undefined;
image?: string | {
light: string;
dark: string;
} | undefined;
decoration?: "gradient" | "grid" | "windows" | undefined;
} | undefined;
public?: boolean | undefined;
logo?: string | {
light: string;
dark: string;
href?: string | undefined;
} | undefined;
favicon?: string | {
light: string;
dark: string;
} | undefined;
api?: {
params?: {
expanded?: "all" | "closed" | undefined;
} | undefined;
openapi?: string | string[] | {
source: string;
directory?: string | undefined;
} | undefined;
playground?: {
display?: "auth" | "simple" | "none" | "interactive" | undefined;
proxy?: boolean | undefined;
} | undefined;
asyncapi?: string | string[] | {
source: string;
directory?: string | undefined;
} | undefined;
examples?: {
languages?: string[] | undefined;
defaults?: "all" | "required" | undefined;
prefill?: boolean | undefined;
autogenerate?: boolean | undefined;
} | undefined;
mdx?: {
server?: string | string[] | undefined;
auth?: {
name?: string | undefined;
method?: "key" | "bearer" | "basic" | "cobo" | undefined;
} | undefined;
} | undefined;
} | undefined;
metadata?: {
timestamp: boolean;
} | undefined;
footer?: {
links?: {
items: {
href: string;
label: string;
}[];
header?: string | undefined;
}[] | undefined;
socials?: Partial<Record<"github" | "x" | "website" | "facebook" | "youtube" | "discord" | "slack" | "linkedin" | "instagram" | "hacker-news" | "medium" | "telegram" | "twitter" | "x-twitter" | "earth-americas" | "bluesky" | "threads" | "reddit" | "podcast", string>> | undefined;
} | undefined;
integrations?: {
amplitude?: {
apiKey: string;
} | undefined;
clarity?: {
projectId: string;
} | undefined;
clearbit?: {
publicApiKey: string;
} | undefined;
fathom?: {
siteId: string;
} | undefined;
ga4?: {
measurementId: string;
} | undefined;
gtm?: {
tagId: string;
} | undefined;
heap?: {
appId: string;
} | undefined;
hightouch?: {
writeKey: string;
apiHost?: string | undefined;
} | undefined;
hotjar?: {
hjid: string;
hjsv: string;
} | undefined;
koala?: {
publicApiKey: string;
} | undefined;
logrocket?: {
appId: string;
} | undefined;
mixpanel?: {
projectToken: string;
} | undefined;
pirsch?: {
id: string;
} | undefined;
posthog?: {
apiKey: string;
apiHost?: string | undefined;
} | undefined;
plausible?: {
domain: string;
server?: string | undefined;
} | undefined;
segment?: {
key: string;
} | undefined;
intercom?: {
appId: string;
} | undefined;
frontchat?: {
snippetId: string;
} | undefined;
telemetry?: {
enabled?: boolean | undefined;
} | undefined;
cookies?: {
value?: string | undefined;
key?: string | undefined;
} | undefined;
} | undefined;
search?: {
prompt?: string | undefined;
} | undefined;
redirects?: {
source: string;
destination: string;
permanent?: boolean | undefined;
}[] | undefined;
seo?: {
metatags?: Record<string, string> | undefined;
indexing?: "all" | "navigable" | undefined;
} | undefined;
description?: string | undefined;
banner?: {
content: string;
dismissible?: boolean | undefined;
} | undefined;
appearance?: {
strict?: boolean | undefined;
default?: "light" | "dark" | "system" | undefined;
} | undefined;
fonts?: {
family: string;
source?: string | undefined;
weight?: number | undefined;
format?: "woff" | "woff2" | undefined;
} | {
body?: {
family: string;
source?: string | undefined;
weight?: number | undefined;
format?: "woff" | "woff2" | undefined;
} | undefined;
heading?: {
family: string;
source?: string | undefined;
weight?: number | undefined;
format?: "woff" | "woff2" | undefined;
} | undefined;
} | undefined;
navbar?: {
primary?: {
type: "button";
href: string;
label: string;
} | {
type: "github";
href: string;
label?: string | undefined;
} | {
type: "discord";
href: string;
label?: string | undefined;
} | undefined;
links?: ({
href: string;
label: string;
type?: string | undefined;
icon?: string | {
name: string;
style?: "brands" | "duotone" | "light" | "regular" | "sharp-duotone-solid" | "sharp-light" | "sharp-regular" | "sharp-solid" | "sharp-thin" | "solid" | "thin" | undefined;
library?: "fontawesome" | "lucide" | undefined;
} | undefined;
} | {
type: "github";
href: string;
icon?: string | {
name: string;
style?: "brands" | "duotone" | "light" | "regular" | "sharp-duotone-solid" | "sharp-light" | "sharp-regular" | "sharp-solid" | "sharp-thin" | "solid" | "thin" | undefined;
library?: "fontawesome" | "lucide" | undefined;
} | undefined;
label?: string | undefined;
} | {
type: "discord";
href: string;
icon?: string | {
name: string;
style?: "brands" | "duotone" | "light" | "regular" | "sharp-duotone-solid" | "sharp-light" | "sharp-regular" | "sharp-solid" | "sharp-thin" | "solid" | "thin" | undefined;
library?: "fontawesome" | "lucide" | undefined;
} | undefined;
label?: string | undefined;
})[] | undefined;
} | undefined;
icons?: {
library: "fontawesome" | "lucide";
} | undefined;
styling?: {
eyebrows?: "section" | "breadcrumbs" | undefined;
codeblocks?: "dark" | "system" | {
languages?: {
custom?: string[] | undefined;
} | undefined;
theme?: "andromeeda" | "aurora-x" | "ayu-dark" | "catppuccin-frappe" | "catppuccin-latte" | "catppuccin-macchiato" | "catppuccin-mocha" | "dark-plus" | "dracula" | "dracula-soft" | "everforest-dark" | "everforest-light" | "github-dark" | "github-dark-default" | "github-dark-dimmed" | "github-dark-high-contrast" | "github-light" | "github-light-default" | "github-light-high-contrast" | "gruvbox-dark-hard" | "gruvbox-dark-medium" | "gruvbox-dark-soft" | "gruvbox-light-hard" | "gruvbox-light-medium" | "gruvbox-light-soft" | "houston" | "kanagawa-dragon" | "kanagawa-lotus" | "kanagawa-wave" | "laserwave" | "light-plus" | "material-theme" | "material-theme-darker" | "material-theme-lighter" | "material-theme-ocean" | "material-theme-palenight" | "min-dark" | "min-light" | "monokai" | "night-owl" | "nord" | "one-dark-pro" | "one-light" | "plastic" | "poimandres" | "red" | "rose-pine" | "rose-pine-dawn" | "rose-pine-moon" | "slack-dark" | "slack-ochin" | "snazzy-light" | "solarized-dark" | "solarized-light" | "synthwave-84" | "tokyo-night" | "vesper" | "vitesse-black" | "vitesse-dark" | "vitesse-light" | "css-variables" | {
light: "andromeeda" | "aurora-x" | "ayu-dark" | "catppuccin-frappe" | "catppuccin-latte" | "catppuccin-macchiato" | "catppuccin-mocha" | "dark-plus" | "dracula" | "dracula-soft" | "everforest-dark" | "everforest-light" | "github-dark" | "github-dark-default" | "github-dark-dimmed" | "github-dark-high-contrast" | "github-light" | "github-light-default" | "github-light-high-contrast" | "gruvbox-dark-hard" | "gruvbox-dark-medium" | "gruvbox-dark-soft" | "gruvbox-light-hard" | "gruvbox-light-medium" | "gruvbox-light-soft" | "houston" | "kanagawa-dragon" | "kanagawa-lotus" | "kanagawa-wave" | "laserwave" | "light-plus" | "material-theme" | "material-theme-darker" | "material-theme-lighter" | "material-theme-ocean" | "material-theme-palenight" | "min-dark" | "min-light" | "monokai" | "night-owl" | "nord" | "one-dark-pro" | "one-light" | "plastic" | "poimandres" | "red" | "rose-pine" | "rose-pine-dawn" | "rose-pine-moon" | "slack-dark" | "slack-ochin" | "snazzy-light" | "solarized-dark" | "solarized-light" | "synthwave-84" | "tokyo-night" | "vesper" | "vitesse-black" | "vitesse-dark" | "vitesse-light" | "css-variables";
dark: "andromeeda" | "aurora-x" | "ayu-dark" | "catppuccin-frappe" | "catppuccin-latte" | "catppuccin-macchiato" | "catppuccin-mocha" | "dark-plus" | "dracula" | "dracula-soft" | "everforest-dark" | "everforest-light" | "github-dark" | "github-dark-default" | "github-dark-dimmed" | "github-dark-high-contrast" | "github-light" | "github-light-default" | "github-light-high-contrast" | "gruvbox-dark-hard" | "gruvbox-dark-medium" | "gruvbox-dark-soft" | "gruvbox-light-hard" | "gruvbox-light-medium" | "gruvbox-light-soft" | "houston" | "kanagawa-dragon" | "kanagawa-lotus" | "kanagawa-wave" | "laserwave" | "light-plus" | "material-theme" | "material-theme-darker" | "material-theme-lighter" | "material-theme-ocean" | "material-theme-palenight" | "min-dark" | "min-light" | "monokai" | "night-owl" | "nord" | "one-dark-pro" | "one-light" | "plastic" | "poimandres" | "red" | "rose-pine" | "rose-pine-dawn" | "rose-pine-moon" | "slack-dark" | "slack-ochin" | "snazzy-light" | "solarized-dark" | "solarized-light" | "synthwave-84" | "tokyo-night" | "vesper" | "vitesse-black" | "vitesse-dark" | "vitesse-light" | "css-variables";
} | undefined;
} | undefined;
latex?: boolean | undefined;
} | undefined;
errors?: {
"404": {
redirect: boolean;
title?: string | undefined;
description?: string | undefined;
};
} | undefined;
contextual?: {
options: ("copy" | "view" | "chatgpt" | "claude" | "perplexity" | "grok" | "mcp" | "cursor" | "vscode" | {
href: string | {
base: string;
query?: {
value: string;
key: string;
}[] | undefined;
};
title: string;
description: string;
icon?: string | {
name: string;
style?: "brands" | "duotone" | "light" | "regular" | "sharp-duotone-solid" | "sharp-light" | "sharp-regular" | "sharp-solid" | "sharp-thin" | "solid" | "thin" | undefined;
library?: "fontawesome" | "lucide" | undefined;
} | undefined;
})[];
} | undefined;
thumbnails?: {
background?: string | undefined;
appearance?: import("@mintlify/validation").ThumbnailAppearance | undefined;
fonts?: {
family: string;
} | undefined;
} | undefined;
interaction?: {
drilldown?: boolean | undefined;
} | undefined;
} | {
name: string;
$schema: string;
theme: "maple";
colors: {
primary: string;
light?: string | undefined;
dark?: string | undefined;
};
navigation: {
products: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").ProductNavigation<"default">[];
global?: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").GlobalNavigation | undefined;
} | {
languages: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").LanguageNavigation<"default">[];
global?: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").GlobalNavigation | undefined;
} | {
versions: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").VersionNavigation<"default">[];
global?: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").GlobalNavigation | undefined;
} | {
tabs: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").TabNavigation<"default">[];
global?: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").GlobalNavigation | undefined;
} | {
dropdowns: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").DropdownNavigation<"default">[];
global?: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").GlobalNavigation | undefined;
} | {
anchors: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").AnchorNavigation<"default">[];
global?: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").GlobalNavigation | undefined;
} | {
groups: ({
openapi: string | string[] | {
source: string;
directory?: string | undefined;
};
group: string;
pages: any[];
icon?: string | {
name: string;
style?: "brands" | "duotone" | "light" | "regular" | "sharp-duotone-solid" | "sharp-light" | "sharp-regular" | "sharp-solid" | "sharp-thin" | "solid" | "thin" | undefined;
library?: "fontawesome" | "lucide" | undefined;
} | undefined;
expanded?: boolean | undefined;
public?: boolean | undefined;
tag?: string | undefined;
hidden?: boolean | undefined;
root?: string | undefined;
} | {
group: string;
pages: any[];
asyncapi: string | string[] | {
source: string;
directory?: string | undefined;
};
icon?: string | {
name: string;
style?: "brands" | "duotone" | "light" | "regular" | "sharp-duotone-solid" | "sharp-light" | "sharp-regular" | "sharp-solid" | "sharp-thin" | "solid" | "thin" | undefined;
library?: "fontawesome" | "lucide" | undefined;
} | undefined;
expanded?: boolean | undefined;
public?: boolean | undefined;
tag?: string | undefined;
hidden?: boolean | undefined;
root?: string | undefined;
} | {
group: string;
pages: any[];
icon?: string | {
name: string;
style?: "brands" | "duotone" | "light" | "regular" | "sharp-duotone-solid" | "sharp-light" | "sharp-regular" | "sharp-solid" | "sharp-thin" | "solid" | "thin" | undefined;
library?: "fontawesome" | "lucide" | undefined;
} | undefined;
expanded?: boolean | undefined;
public?: boolean | undefined;
tag?: string | undefined;
hidden?: boolean | undefined;
root?: string | undefined;
})[];
global?: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").GlobalNavigation | undefined;
} | {
pages: any[];
global?: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").GlobalNavigation | undefined;
};
background?: {
color?: {
light?: string | undefined;
dark?: string | undefined;
} | undefined;
image?: string | {
light: string;
dark: string;
} | undefined;
decoration?: "gradient" | "grid" | "windows" | undefined;
} | undefined;
public?: boolean | undefined;
logo?: string | {
light: string;
dark: string;
href?: string | undefined;
} | undefined;
favicon?: string | {
light: string;
dark: string;
} | undefined;
api?: {
params?: {
expanded?: "all" | "closed" | undefined;
} | undefined;
openapi?: string | string[] | {
source: string;
directory?: string | undefined;
} | undefined;
playground?: {
display?: "auth" | "simple" | "none" | "interactive" | undefined;
proxy?: boolean | undefined;
} | undefined;
asyncapi?: string | string[] | {
source: string;
directory?: string | undefined;
} | undefined;
examples?: {
languages?: string[] | undefined;
defaults?: "all" | "required" | undefined;
prefill?: boolean | undefined;
autogenerate?: boolean | undefined;
} | undefined;
mdx?: {
server?: string | string[] | undefined;
auth?: {
name?: string | undefined;
method?: "key" | "bearer" | "basic" | "cobo" | undefined;
} | undefined;
} | undefined;
} | undefined;
metadata?: {
timestamp: boolean;
} | undefined;
footer?: {
links?: {
items: {
href: string;
label: string;
}[];
header?: string | undefined;
}[] | undefined;
socials?: Partial<Record<"github" | "x" | "website" | "facebook" | "youtube" | "discord" | "slack" | "linkedin" | "instagram" | "hacker-news" | "medium" | "telegram" | "twitter" | "x-twitter" | "earth-americas" | "bluesky" | "threads" | "reddit" | "podcast", string>> | undefined;
} | undefined;
integrations?: {
amplitude?: {
apiKey: string;
} | undefined;
clarity?: {
projectId: string;
} | undefined;
clearbit?: {
publicApiKey: string;
} | undefined;
fathom?: {
siteId: string;
} | undefined;
ga4?: {
measurementId: string;
} | undefined;
gtm?: {
tagId: string;
} | undefined;
heap?: {
appId: string;
} | undefined;
hightouch?: {
writeKey: string;
apiHost?: string | undefined;
} | undefined;
hotjar?: {
hjid: string;
hjsv: string;
} | undefined;
koala?: {
publicApiKey: string;
} | undefined;
logrocket?: {
appId: string;
} | undefined;
mixpanel?: {
projectToken: string;
} | undefined;
pirsch?: {
id: string;
} | undefined;
posthog?: {
apiKey: string;
apiHost?: string | undefined;
} | undefined;
plausible?: {
domain: string;
server?: string | undefined;
} | undefined;
segment?: {
key: string;
} | undefined;
intercom?: {
appId: string;
} | undefined;
frontchat?: {
snippetId: string;
} | undefined;
telemetry?: {
enabled?: boolean | undefined;
} | undefined;
cookies?: {
value?: string | undefined;
key?: string | undefined;
} | undefined;
} | undefined;
search?: {
prompt?: string | undefined;
} | undefined;
redirects?: {
source: string;
destination: string;
permanent?: boolean | undefined;
}[] | undefined;
seo?: {
metatags?: Record<string, string> | undefined;
indexing?: "all" | "navigable" | undefined;
} | undefined;
description?: string | undefined;
banner?: {
content: string;
dismissible?: boolean | undefined;
} | undefined;
appearance?: {
strict?: boolean | undefined;
default?: "light" | "dark" | "system" | undefined;
} | undefined;
fonts?: {
family: string;
source?: string | undefined;
weight?: number | undefined;
format?: "woff" | "woff2" | undefined;
} | {
body?: {
family: string;
source?: string | undefined;
weight?: number | undefined;
format?: "woff" | "woff2" | undefined;
} | undefined;
heading?: {
family: string;
source?: string | undefined;
weight?: number | undefined;
format?: "woff" | "woff2" | undefined;
} | undefined;
} | undefined;
navbar?: {
primary?: {
type: "button";
href: string;
label: string;
} | {
type: "github";
href: string;
label?: string | undefined;
} | {
type: "discord";
href: string;
label?: string | undefined;
} | undefined;
links?: ({
href: string;
label: string;
type?: string | undefined;
icon?: string | {
name: string;
style?: "brands" | "duotone" | "light" | "regular" | "sharp-duotone-solid" | "sharp-light" | "sharp-regular" | "sharp-solid" | "sharp-thin" | "solid" | "thin" | undefined;
library?: "fontawesome" | "lucide" | undefined;
} | undefined;
} | {
type: "github";
href: string;
icon?: string | {
name: string;
style?: "brands" | "duotone" | "light" | "regular" | "sharp-duotone-solid" | "sharp-light" | "sharp-regular" | "sharp-solid" | "sharp-thin" | "solid" | "thin" | undefined;
library?: "fontawesome" | "lucide" | undefined;
} | undefined;
label?: string | undefined;
} | {
type: "discord";
href: string;
icon?: string | {
name: string;
style?: "brands" | "duotone" | "light" | "regular" | "sharp-duotone-solid" | "sharp-light" | "sharp-regular" | "sharp-solid" | "sharp-thin" | "solid" | "thin" | undefined;
library?: "fontawesome" | "lucide" | undefined;
} | undefined;
label?: string | undefined;
})[] | undefined;
} | undefined;
icons?: {
library: "fontawesome" | "lucide";
} | undefined;
styling?: {
eyebrows?: "section" | "breadcrumbs" | undefined;
codeblocks?: "dark" | "system" | {
languages?: {
custom?: string[] | undefined;
} | undefined;
theme?: "andromeeda" | "aurora-x" | "ayu-dark" | "catppuccin-frappe" | "catppuccin-latte" | "catppuccin-macchiato" | "catppuccin-mocha" | "dark-plus" | "dracula" | "dracula-soft" | "everforest-dark" | "everforest-light" | "github-dark" | "github-dark-default" | "github-dark-dimmed" | "github-dark-high-contrast" | "github-light" | "github-light-default" | "github-light-high-contrast" | "gruvbox-dark-hard" | "gruvbox-dark-medium" | "gruvbox-dark-soft" | "gruvbox-light-hard" | "gruvbox-light-medium" | "gruvbox-light-soft" | "houston" | "kanagawa-dragon" | "kanagawa-lotus" | "kanagawa-wave" | "laserwave" | "light-plus" | "material-theme" | "material-theme-darker" | "material-theme-lighter" | "material-theme-ocean" | "material-theme-palenight" | "min-dark" | "min-light" | "monokai" | "night-owl" | "nord" | "one-dark-pro" | "one-light" | "plastic" | "poimandres" | "red" | "rose-pine" | "rose-pine-dawn" | "rose-pine-moon" | "slack-dark" | "slack-ochin" | "snazzy-light" | "solarized-dark" | "solarized-light" | "synthwave-84" | "tokyo-night" | "vesper" | "vitesse-black" | "vitesse-dark" | "vitesse-light" | "css-variables" | {
light: "andromeeda" | "aurora-x" | "ayu-dark" | "catppuccin-frappe" | "catppuccin-latte" | "catppuccin-macchiato" | "catppuccin-mocha" | "dark-plus" | "dracula" | "dracula-soft" | "everforest-dark" | "everforest-light" | "github-dark" | "github-dark-default" | "github-dark-dimmed" | "github-dark-high-contrast" | "github-light" | "github-light-default" | "github-light-high-contrast" | "gruvbox-dark-hard" | "gruvbox-dark-medium" | "gruvbox-dark-soft" | "gruvbox-light-hard" | "gruvbox-light-medium" | "gruvbox-light-soft" | "houston" | "kanagawa-dragon" | "kanagawa-lotus" | "kanagawa-wave" | "laserwave" | "light-plus" | "material-theme" | "material-theme-darker" | "material-theme-lighter" | "material-theme-ocean" | "material-theme-palenight" | "min-dark" | "min-light" | "monokai" | "night-owl" | "nord" | "one-dark-pro" | "one-light" | "plastic" | "poimandres" | "red" | "rose-pine" | "rose-pine-dawn" | "rose-pine-moon" | "slack-dark" | "slack-ochin" | "snazzy-light" | "solarized-dark" | "solarized-light" | "synthwave-84" | "tokyo-night" | "vesper" | "vitesse-black" | "vitesse-dark" | "vitesse-light" | "css-variables";
dark: "andromeeda" | "aurora-x" | "ayu-dark" | "catppuccin-frappe" | "catppuccin-latte" | "catppuccin-macchiato" | "catppuccin-mocha" | "dark-plus" | "dracula" | "dracula-soft" | "everforest-dark" | "everforest-light" | "github-dark" | "github-dark-default" | "github-dark-dimmed" | "github-dark-high-contrast" | "github-light" | "github-light-default" | "github-light-high-contrast" | "gruvbox-dark-hard" | "gruvbox-dark-medium" | "gruvbox-dark-soft" | "gruvbox-light-hard" | "gruvbox-light-medium" | "gruvbox-light-soft" | "houston" | "kanagawa-dragon" | "kanagawa-lotus" | "kanagawa-wave" | "laserwave" | "light-plus" | "material-theme" | "material-theme-darker" | "material-theme-lighter" | "material-theme-ocean" | "material-theme-palenight" | "min-dark" | "min-light" | "monokai" | "night-owl" | "nord" | "one-dark-pro" | "one-light" | "plastic" | "poimandres" | "red" | "rose-pine" | "rose-pine-dawn" | "rose-pine-moon" | "slack-dark" | "slack-ochin" | "snazzy-light" | "solarized-dark" | "solarized-light" | "synthwave-84" | "tokyo-night" | "vesper" | "vitesse-black" | "vitesse-dark" | "vitesse-light" | "css-variables";
} | undefined;
} | undefined;
latex?: boolean | undefined;
} | undefined;
errors?: {
"404": {
redirect: boolean;
title?: string | undefined;
description?: string | undefined;
};
} | undefined;
contextual?: {
options: ("copy" | "view" | "chatgpt" | "claude" | "perplexity" | "grok" | "mcp" | "cursor" | "vscode" | {
href: string | {
base: string;
query?: {
value: string;
key: string;
}[] | undefined;
};
title: string;
description: string;
icon?: string | {
name: string;
style?: "brands" | "duotone" | "light" | "regular" | "sharp-duotone-solid" | "sharp-light" | "sharp-regular" | "sharp-solid" | "sharp-thin" | "solid" | "thin" | undefined;
library?: "fontawesome" | "lucide" | undefined;
} | undefined;
})[];
} | undefined;
thumbnails?: {
background?: string | undefined;
appearance?: import("@mintlify/validation").ThumbnailAppearance | undefined;
fonts?: {
family: string;
} | undefined;
} | undefined;
interaction?: {
drilldown?: boolean | undefined;
} | undefined;
} | {
name: string;
$schema: string;
theme: "palm";
colors: {
primary: string;
light?: string | undefined;
dark?: string | undefined;
};
navigation: {
products: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").ProductNavigation<"default">[];
global?: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").GlobalNavigation | undefined;
} | {
languages: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").LanguageNavigation<"default">[];
global?: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").GlobalNavigation | undefined;
} | {
versions: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").VersionNavigation<"default">[];
global?: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").GlobalNavigation | undefined;
} | {
tabs: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").TabNavigation<"default">[];
global?: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").GlobalNavigation | undefined;
} | {
dropdowns: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").DropdownNavigation<"default">[];
global?: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").GlobalNavigation | undefined;
} | {
anchors: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").AnchorNavigation<"default">[];
global?: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").GlobalNavigation | undefined;
} | {
groups: ({
openapi: string | string[] | {
source: string;
directory?: string | undefined;
};
group: string;
pages: any[];
icon?: string | {
name: string;
style?: "brands" | "duotone" | "light" | "regular" | "sharp-duotone-solid" | "sharp-light" | "sharp-regular" | "sharp-solid" | "sharp-thin" | "solid" | "thin" | undefined;
library?: "fontawesome" | "lucide" | undefined;
} | undefined;
expanded?: boolean | undefined;
public?: boolean | undefined;
tag?: string | undefined;
hidden?: boolean | undefined;
root?: string | undefined;
} | {
group: string;
pages: any[];
asyncapi: string | string[] | {
source: string;
directory?: string | undefined;
};
icon?: string | {
name: string;
style?: "brands" | "duotone" | "light" | "regular" | "sharp-duotone-solid" | "sharp-light" | "sharp-regular" | "sharp-solid" | "sharp-thin" | "solid" | "thin" | undefined;
library?: "fontawesome" | "lucide" | undefined;
} | undefined;
expanded?: boolean | undefined;
public?: boolean | undefined;
tag?: string | undefined;
hidden?: boolean | undefined;
root?: string | undefined;
} | {
group: string;
pages: any[];
icon?: string | {
name: string;
style?: "brands" | "duotone" | "light" | "regular" | "sharp-duotone-solid" | "sharp-light" | "sharp-regular" | "sharp-solid" | "sharp-thin" | "solid" | "thin" | undefined;
library?: "fontawesome" | "lucide" | undefined;
} | undefined;
expanded?: boolean | undefined;
public?: boolean | undefined;
tag?: string | undefined;
hidden?: boolean | undefined;
root?: string | undefined;
})[];
global?: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").GlobalNavigation | undefined;
} | {
pages: any[];
global?: import("@mintlify/validation/dist/mint-config/schemas/v2/properties/navigation/divisionNav.js").GlobalNavigation | undefined;
};
background?: {
color?: {
light?: string | undefined;
dark?: string | undefined;
} | undefined;
image?: string | {
light: string;
dark: string;
} | undefined;
decoration?: "gradient" | "grid" | "windows" | undefined;
} | undefined;
public?: boolean | undefined;
logo?: string | {
light: string;
dark: string;
href?: string | undefined;
} | undefined;
favicon?: string | {
light: string;
dark: string;
} | undefined;
api?: {
params?: {
expanded?: "all" | "closed" | undefined;
} | undefined;
openapi?: string | string[] | {
source: string;
directory?: string | undefined;
} | undefined;
playground?: {
display?: "auth" | "simple" | "none" | "interactive" | undefined;
proxy?: boolean | undefined;
} | undefined;
asyncapi?: string | string[] | {
source: string;
directory?: string | undefined;
} | undefined;
examples?: {
languages?: string[] | undefined;
defaults?: "all" | "required" | undefined;
prefill?: boolean | undefined;
autogenerate?: boolean | undefined;
} | undefined;
mdx?: {
server?: string | string[] | undefined;
auth?: {
name?: string | undefined;
method?: "key" | "bearer" | "basic" | "cobo" | undefined;
} | undefined;
} | undefined;
} | undefined;
metadata?: {
timestamp: boolean;
} | undefined;
footer?: {
links?: {
items: {
href: string;
label: string;
}[];
header?: string | undefined;
}[] | undefined;
socials?: Partial<Record<"github" | "x" | "website" | "facebook" | "youtube" | "discord" | "slack" | "linkedin" | "instagram" | "hacker-news" | "medium" | "telegram" | "twitter" | "x-twitter" | "earth-americas" | "bluesky" | "threads" | "reddit" | "podcast", string>> | undefined;
} | undefined;
integrations?: {
amplitude?: {
apiKey: string;
} | undefined;
clarity?: {
projectId: string;
} | undefined;
clearbit?: {
publicApiKey: string;
} | undefined;
fathom?: {
siteId: string;
} | undefined;
ga4?: {
measurementId: string;
} | undefined;
gtm?: {
tagId: string;
} | undefined;
heap?: {
appId: string;
} | undefined;
hightouch?: {
writeKey: string;
apiHost?: string | undefined;
} | undefined;
hotjar?: {
hjid: string;
hjsv: string;
} | undefined;
koala?: {
publicApiKey: string;
} | undefined;
logrocket?: {
appId: string;
} | undefined;
mixpanel?: {
projectToken: string;
} | undefined;
pirsch?: {
id: string;
} | undefined;
posthog?: {
apiKey: string;
apiHost?: string | undefined;
} | undefined;
plausible?: {
domain: string;
server?: string | undefined;
} | undefined;
segment?: {
key: string;
} | undefined;
intercom?: {
appId: string;
} | undefined;
frontchat?: {
snippetId: string;
} | undefined;
telemetry?: {
enabled?: boolean | undefined;
} | undefined;
cookies?: {
value?: string | undefined;
key?: string | undefined;
} | undefined;
} | undefined;
search?: {
prompt?: string | undefined;
} | undefined;
redirects?: {
source: string;
destination: string;
permanent?: boolean | undefined;
}[] | undefined;
seo?: {
metatags?: Record<string, string> | undefined;
indexing?: "all" | "navigable" | undefined;
} | undefined;
description?: string | undefined;
banner?: {
content: string;
dismissible?: boolean | undefined;
} | undefined;
appearance?: {
strict?: boolean | undefined;
default?: "light" | "dark" | "system" | undefined;
} | undefined;
fonts?: {
family: string;
source?: string | undefined;
weight?: number | undefined;
format?: "woff" | "woff2" | undefined;
} | {
body?: {
family: string;
source?: string | undefined;
weight?: number | undefined;
format?: "woff" | "woff2" | undefined;
} | undefined;
heading?: {
family: string;
source?: string | undefined;
weight?: number | undefined;
format?: "woff" | "woff2" | undefined;
} | undefined;
} | undefined;
navbar?: {
primary?: {
type: "button";
href: string;
label: string;
} | {
type: "github";
href: string;
label?: string | undefined;
} | {
type: "discord";
href: string;
label?: string | undefined;
} | undefined;
links?: ({
href: string;
label: string;
type?: string | undefined;
icon?: string | {
name: string;
style?: "brands" | "duotone" | "light" | "regular" | "sharp-duotone-solid" | "sharp-light" | "sharp-regular" | "sharp-solid" | "sharp-thin" | "solid" | "thin" | undefined;
library?: "fontawesome" | "lucide" | undefined;
} | undefined;
} | {
type: "github";
href: string;
icon?: string | {
name: string;
style?: "brands" | "duotone" | "light" | "regular" | "sharp-duotone-solid" | "sharp-light" | "sharp-regular" | "sharp-solid" | "sharp-thin" | "solid" | "thin" | undefined;
library?: "fontawesome" | "lucide" | undefined;
} | undefined;
label?: string | undefined;
} | {
type: "discord";
href: string;
icon?: string | {
name: string;
style?: "brands" | "duotone" | "light" | "regular" | "sharp-duotone-solid" | "sharp-light" | "sharp-regular" | "sharp-solid" | "sharp-thin" | "solid" | "thin" | undefined;
library?: "fontawesome" | "lucide" | undefined;
} | undefined;
label?: string | undefined;
})[] | undefined;
} | undefined;
icons?: {
library: "fontawesome" | "lucide";
} | undefined;
styling?: {
eyebrows?: "section" | "breadcrumbs" | undefined;
codeblocks?: "dark" | "system" | {
languages?: {
custom?: string[] | undefined;
} | undefined;
theme?: "andromeeda" | "aurora-x" | "ayu-dark" | "catppuccin-frappe" | "catppuccin-latte" | "catppuccin-macchiato" | "catppuccin-mocha" | "dark-plus" | "dracula" | "dracula-soft" | "everforest-dark" | "everforest-light" | "github-dark" | "github-dark-default" | "github-dark-dimmed" | "github-dark-high-contrast" | "github-light" | "github-light-default" | "github-light-high-contrast" | "gruvbox-dark-hard" | "gruvbox-dark-medium" | "gruvbox-dark-soft" | "gruvbox-light-hard" | "gruvbox-light-medium" | "gruvbox-light-soft" | "houston" | "kanagawa-dragon" | "kanagawa-lotus" | "kanagawa-wave" | "laserwave" | "light-plus" | "material-theme" | "material-theme-darker" | "material-theme-lighter" | "material-theme-ocean" | "material-theme-palenight" | "min-dark" | "min-light" | "monokai" | "night-owl" | "nord" | "one-dark-pro" | "one-light" | "plastic" | "poimandres" | "red" | "rose-pine" | "rose-pine-dawn" | "rose-pine-moon" | "slack-dark" | "slack-ochin" | "snazzy-light" | "solarized-dark" | "solarized-light" | "synthwave-84" | "tokyo-night" | "vesper" | "vitesse-black" | "vitesse-dark" | "vitesse-light" | "css-variables" | {
light: "andromeeda" | "aurora-x" | "ayu-dark" | "catppuccin-frappe" | "catppuccin-latte" | "catppuccin-macchiato" | "catppuccin-mocha" | "dark-plus" | "dracula" | "dracula-soft" | "everforest-dark" | "everforest-light" | "github-dark" | "github-dark-default" | "github-dark-dimmed" | "github-dark-high-contrast" | "github-light" | "github-light-default" | "github-light-high-contrast" | "gruvbox-dark-hard" | "gruvbox-dark-medium" | "gruvbox-dark-soft" | "gruvbox-light-hard" | "gruvbox-light-medium" | "gruvbox-light-soft" | "houston" | "kanagawa-dragon" | "kanagawa-lotus" | "kanagawa-wave" | "laserwave" | "light-plus" | "material-theme" | "material-theme-darker" | "material-theme-lighter" | "material-theme-ocean" | "material-theme-palenight" | "min-dark" | "min-light" | "monokai" | "night-owl" | "nord" | "one-dark-pro" | "one-light" | "plastic" | "poimandres" | "red" | "rose-pine" | "rose-pine-dawn" | "rose-pine-moon" | "slack-dark" | "slack-ochin" | "snazzy-light" | "solarized-dark" | "solarized-light" | "synthwave-84" | "tokyo-night" | "vesper" | "vitesse-black" | "vitesse-dark" | "vitesse-light" | "css-variables";
dark: "andromeeda" | "aurora-x" | "ayu-dark" | "catppuccin-frappe" | "catppuccin-latte" | "catppuccin-macchiato" | "catppuccin-mocha" | "dark-plus" | "dracula" | "dracula-soft" | "everforest-dark" | "everforest-light" | "github-dark" | "github-dark-default" | "github-dark-dimmed" | "github-dark-high-contrast" | "github-light" | "github-light-default" | "github-light-high-contrast" | "gruvbox-dark-hard" | "gruvbox-dark-medium" | "gruvbox-dark-soft" | "gruvbox-light-hard" | "gruvbox-light-medium" | "gruvbox-light-soft" | "houston" | "kanagawa-dragon" | "kanagawa-lotus" | "kanagawa-wave" | "laserwave" | "light-plus" | "material-theme" | "material-theme-darker" | "material-theme-lighter" | "material-theme-ocean" | "material-theme-palenight" | "min-dark" | "min-light" | "monokai" | "night-owl" | "nord" | "one-dark-pro" | "one-light" | "plastic" | "poimandres" | "red" | "rose-pine" | "rose-pine-dawn" | "rose-pine-moon" | "slack-dark" | "slack-ochin" | "snazzy-light" | "solarized-dark" | "solarized-light" | "synthwave-84" | "tokyo-night" | "vesper" | "vitesse-black" | "vitesse-dark" | "vitesse-light" | "css-variables";
} | undefined;
} | undefined;
latex?: boolean | undefined;
} | undefined;
errors?: {
"404": {
redirect: boolean;
title?: string | undefined;
description?: string | undefined;
};
} | undefined;
contextual?: {
options: ("copy" | "view" | "chatgpt" | "claude" | "perplexity" | "grok" | "mcp" | "cursor" | "vscode" | {
href: string | {
base: string;
query?: {
value: string;
key: string;
}[] | undefined;
};
title: string;
description: string;
icon?: string | {
name: string;
style?: "brands" | "duotone" | "light" | "regular" | "sharp-duotone-solid" | "sharp-light" | "sharp-regular" | "sharp-solid" | "sharp-thin" | "solid" | "thin" | undefined;
library?: "fontawesome" | "lucide" | undefined;
} | undefined;
})[];
} | undefined;
thumbnails?: {
background?: string | undefined;
appearance?: import("@mintlify/validation").ThumbnailAppearance | undefined;
fonts?: {
family: string;
} | undefined;
} | undefined;
interac