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.
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.