Skip to main content

Top-Level Fields

version
string

Config version. Use 0.1.

name
string
required

Site name.

description
string

Site description for metadata and UI context.

theme
string

Theme name. Use phase.

logo
string | object

Logo path, or light and dark logo paths.

favicon
string

Favicon path.

styling
object

Styling options.

colors
object

Brand colors.

appearance
object

Theme mode settings.

navbar
object

Top navigation links and primary button.

navigation
object
required

Main docs structure, including tabs and optional languages.

footer
object

Footer links and social links.

redirects
array

Redirect rules.

search
object

Search prompt text.

errors
object

Not-found behavior.

appearance.default
light | dark | system

Default theme mode.

appearance.strict
boolean

If true, Relevate always uses the selected mode.

colors.primary
string
required

Primary accent color.

colors.light
string

Light-mode accent color.

colors.dark
string

Dark-mode accent color.

colors.background
object

Optional background colors for light and dark mode.

navigation.tabs
array
required

Top-level tabs.

navigation.languages
object

Language switcher settings.

navigation.languages.default
string

Default language code.

navigation.languages.items
string[]

Languages shown in the switcher.

Node
string | object

A page, a page object, or a grouped section.

Node.languages
string[]

Optional language filter for a page or group.

Minimal Valid Config

{
"version": "0.1",
"name": "My Docs",
"navigation": {
"tabs": [
{
"id": "docs",
"label": "Documentation",
"content": ["index"]
}
]
}
}

Minimal Multilingual Config

{
"version": "0.1",
"name": "My Docs",
"navigation": {
"languages": {
"default": "en",
"items": ["en", "fr", "jp"]
},
"tabs": [
{
"id": "docs",
"label": {
"en": "Docs",
"fr": "Documentation",
"jp": "ドキュメント"
},
"content": ["index", "getting-started"]
}
]
}
}