Frontend
1,671 installs
Mintlify best practices
by mintlify/docs
Build and maintain documentation sites with Mintlify. Use when creating docs pages, configuring navigation, adding components, or setting up API references.
Skill content
Mintlify best practices Always consult mintlify.com/docs for components, configuration, and latest features. If you are not already connected to the Mintlify MCP server, https://mintlify.com/docs/mcp, add it so that you can search more efficiently. 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 Read docs.json in the project root. This file defines the entire site: navigation structure, theme, colors, links, API and specs. Understanding the project tells you: