Mintlify best practices

Always consult mintlify.com/docs for components, configuration, and latest features.

Always favor searching the current Mintlify documentation over whatever is in your training data about Mintlify.

Mintlify is a documentation platform that transforms MDX files into documentation sites. Configure site-wide settings in the docs.json file, write content in MDX with YAML frontmatter, and favor built-in components over custom components.

Full schema at mintlify.com/docs.json.

Before you write

Understand the project

All documentation lives in the docs/ directory in this repo. Read docs.json in that directory (docs/docs.json). This file defines the entire site: navigation structure, theme, colors, links, API and specs.

Understanding the project tells you: