Skip to main content
CodivDocs

Configuration File

Reference for codiv.config.json options.

CodivDocs is configured via a codiv.config.json file in your repository root.

Minimal example

{
  "name": "My Docs",
  "navigation": [
    {
      "group": "Getting Started",
      "pages": ["docs/introduction"]
    }
  ]
}

Full reference

FieldTypeRequiredDescription
namestringYesYour documentation site name
themeobjectNoTheme customization
navigationarrayYesSidebar navigation groups
apiobjectNoAPI playground configuration
versionsstring[]NoVersion labels
redirectsarrayNoURL redirects
footerobjectNoFooter configuration

Navigation

Navigation is defined as an array of groups:

{
  "navigation": [
    {
      "group": "Group Name",
      "pages": [
        "docs/page-one",
        "docs/page-two",
        {
          "group": "Nested Group",
          "pages": ["docs/nested/page"]
        }
      ]
    }
  ]
}

Page paths are relative to the repo root, without the file extension.

Theme

{
  "theme": {
    "primary": "#ffffff",
    "logo": {
      "light": "/logo-light.svg",
      "dark": "/logo-dark.svg"
    },
    "font": "Geist Sans",
    "codeTheme": "github-dark"
  }
}

Last updated April 12, 2026