The navigation field in docs.json controls the sidebar, tab bar, and overall site structure. Holocron supports a Mintlify-compatible subset of navigation shapes.

Simplest form: flat groups

123456789101112{
  "navigation": [
    {
      "group": "Getting Started",
      "pages": ["index", "quickstart"]
    },
    {
      "group": "Guides",
      "pages": ["guides/auth", "guides/deployment"]
    }
  ]
}

This creates a single sidebar with two collapsible sections.

Tabs

Tabs split the sidebar into multiple top-level areas. Each tab has its own set of groups:

1234567891011121314151617{
  "navigation": {
    "tabs": [
      {
        "tab": "Documentation",
        "groups": [
          { "group": "Overview", "pages": ["index"] },
          { "group": "Guides", "pages": ["guides/setup"] }
        ]
      },
      {
        "tab": "API Reference",
        "openapi": "openapi.json"
      }
    ]
  }
}

Clicking a tab switches the sidebar content. The tab bar appears below the navbar.

Link-only tabs

A tab can be an external link instead of a content section:

1234{
  "tab": "GitHub",
  "href": "https://github.com/example/docs"
}

Nested groups

Groups can contain other groups for deeper hierarchy:

12345678910{
  "group": "Authentication",
  "pages": [
    "auth/overview",
    {
      "group": "Providers",
      "pages": ["auth/github", "auth/google", "auth/email"]
    }
  ]
}

Group options

Field	Type	Description
`group`	string	Section title in the sidebar
`pages`	array	Page slugs or nested groups
`icon`	string	Icon displayed next to the group title
`hidden`	boolean	Hide the entire group from navigation
`expanded`	boolean	Whether the group starts expanded
`root`	string	Page slug to use as the group's clickable header
`tag`	string	Badge label next to the group title

Anchors

Anchors are persistent links rendered in the tab bar. They can be internal or external and appear alongside tabs regardless of which tab is active:

12345678910111213{
  "navigation": {
    "tabs": [
      { "tab": "Docs", "groups": [...] }
    ],
    "global": {
      "anchors": [
        { "anchor": "GitHub", "href": "https://github.com/example", "icon": "github" },
        { "anchor": "Discord", "href": "https://discord.gg/example", "icon": "message-circle" }
      ]
    }
  }
}