mintlify

docs: Mintlify Documentation for Developers

The Mintlify docs repository contains the official documentation in MDX format. It is for contributors who want to update the docs and preview changes locally with the Mint CLI.

View on GitHub Compare
Stars
452
Forks
248
Stars, last 30 days
+9

Our take

Health score

65/100

How it is scored
Activity
52
Community
83
Issues
46
Pull requests
78

+9 stars in the last 30 days

  • Merges more pull requests than 84% of the projects we track
  • More contributors than 78% of the projects we track

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

467

Forks

249

Change since Nov 17, 2026: 0 stars·+1 forks

Overview

This repository contains the official documentation for Mintlify, written in MDX. It provides the documentation source for contributors who need to update or review Mintlify docs.

The project is suited to people working on the documentation itself. Its README describes a local preview workflow using the Mint CLI and points contributors to a contribution guide and style guide.

Key Features

  • Official Mintlify documentation source.
  • Documentation content written in MDX.
  • Local preview workflow using mint dev.
  • Uses docs.json as the location marker for running the local preview command.
  • Includes a contribution guide and a documentation style guide.
  • Links to the Mintlify documentation site.

Use Cases

  • Contributors previewing documentation changes before submitting them.
  • Writers updating Mintlify documentation and checking the result locally.
  • Maintainers referring contributors to shared contribution and style guidance.

Getting Started

Install the Mint CLI and start the local preview from the documentation root, where docs.json is located:

npm i -g mint
mint dev

See the README for details, and consult CONTRIBUTING.md and style-guide/README.md before contributing.

Alternatives

  • MkDocs: MkDocs builds documentation sites from Markdown and YAML configuration, rather than providing Mintlify's MDX docs and Mint CLI workflow.
  • sphinx: Sphinx generates documentation primarily from reStructuredText, with its own build and publishing workflow instead of Mintlify's MDX setup.
  • fern: Fern generates API documentation and SDKs from API definitions, rather than maintaining general-purpose docs as MDX files.
ProjectLanguageLicenseStarsStatus
docsMDXMIT452Not checked yet
mkdocsPythonBSD-2-Clause22.5kInactive
sphinxPython–8.1kMaintained
fernTypeScriptApache-2.03.8kActive

Considerations

  • This repository is documentation content, not a general-purpose software library or application.
  • Local preview requires the Mint CLI, installed through npm.
  • The README points contributors to separate contribution and style guidance; review those before making changes.

Found this useful?

Share it with someone who would like docs.

Comparisons