Navigation

The sidebar navigation is defined using meta.json files placed in each content directory.

Create a meta.json file in your docs directory to control page order:

{
  "title": "Documentation",
  "pages": ["index", "about", "quickstart"]
}

Pages are referenced by their filename without the .mdx extension.

Nested groups

Use the ...folder syntax to include a folder as a nested group:

{
  "title": "Documentation",
  "pages": [
    "index",
    "about",
    "...platform",
    "...guides"
  ]
}

Each folder should have its own meta.json:

{
  "title": "Platform",
  "pages": ["lifeverse-ai", "multi-agent-architecture", "open-source"]
}

Add visual separators in the sidebar using the ---Title--- syntax:

{
  "pages": [
    "index",
    "---Getting Started---",
    "...platform",
    "---Reference---",
    "...api-reference"
  ]
}

Place your MDX files in folders and reference them in the parent meta.json. Each folder with a meta.json becomes a sidebar group.

MDX files not listed in any meta.json will still be accessible via direct URL and search, but won't appear in the sidebar navigation.