Skip to main content
Mintlify’s site configuration lives in docs.json at the root of this docs app (apps/docs). The legacy mint.json format is deprecated; this repo uses docs.json only.
Full property reference: Mintlify docs.json schema. Required fields include theme, name, colors.primary, and navigation.

​
This repository

FileRole
apps/docs/docs.jsonTheme, name, colors, logo, navigation (tabs + groups), navbar, footer, global anchors.
apps/docs/**/*.mdxPage content; every page you want in the sidebar must appear under navigation in docs.json.

​
Example structure

GoalGen uses two top-level tabs in navigation.tabs: Documentation (Get Started, Creator Studio, Essentials) and API Reference. Sidebar anchors (Documentation, Community, Blog) are under navigation.global.anchors. 
{
  "$schema": "https://mintlify.com/docs.json",
  "theme": "mint",
  "name": "GoalGen",
  "colors": {
    "primary": "#0D9373",
    "light": "#07C983",
    "dark": "#0D9373"
  },
  "navigation": {
    "tabs": [
      {
        "tab": "Documentation",
        "groups": [
          {
            "group": "Creator Studio",
            "pages": [
              "creator-studio/overview",
              "creator-studio/content-library",
              "creator-studio/rbac"
            ]
          }
        ]
      }
    ],
    "global": {
      "anchors": []
    }
  },
  "navbar": {
    "links": [{ "label": "Support", "href": "mailto:hello@goalgen.ai" }],
    "primary": {
      "type": "button",
      "label": "GitHub",
      "href": "https://github.com/DLT-CAFE/goalgen"
    }
  }
}
Edit docs.json when you add a new MDX page, then add its path (without .mdx) to the right group.pages array.
  • navbar.links — Text links (e.g. Support).
  • navbar.primary — Primary call-to-action button (type, label, href).
  • footer.socials — Keys such as github, x, linkedin with profile URLs.

Navigation

How sidebar navigation maps to docs.json.

Mintlify settings

Official schema for every docs.json field.