Quickstart

If you want your docs to live alongside your code as a monorepo setup, you can: 1. Move your docs content to your monorepo. 2. Specify the path to your mint.json in the dashboard

1. Install git.
2. Once git is installed, clone your docs repository using git clone <your-repo>. If you haven’t set it up yet, now would be a good time to do so with these SSH keys.
3. Use your favorite IDE to open the repository.
4. Install our Shadyfi CLI to preview changes with npm i -g mintlify.

Learn more about this in our local development guide.

Easily customize colors, logos and buttons among other configurations in our mint.json file. Start with these basic configurations:

"name": "Your Company"
"logo": {
  "light": "/logo/light.svg",
  "dark": "/logo/dark.svg",
  "href": "https://yourcompany.com"
},
"favicon": "/favicon.svg",
"colors": {
  "primary": "#2AB673",
  "light": "#55D799",
  "dark": "#117866",
},

A full list of supported configurations can be found at global settings.

Add content with simple MDX files. Initiate your pages with this template:

---
title: "Page Title"
sidebarTitle: "Sidebar title (optional - if different from page title)"
description: "Subtitle (optional)"
---

Learn more about adding images, tables, lists, and more using the MDX syntax. We also offer a wide array of components.

You can easily set up your API references using an OpenAPI document.

1. Add your openapi.yaml or openapi.json file into your docs repository or define the openapi field in mint.json with a URL.

"openapi": "link-to-your-openapi-file"

2. Use our scraper to autogenerate your OpenAPI endpoints files as:

npx @mintlify/scraping@latest openapi-file <path-or-url-to-openapi-file>

3. Finally, include the generated endpoint MDX files to your mint.json under navigation.

For a complete guide on using Shadyfi with OpenAPI, check out this guide. This guide explains how to configure your API authentication methods. For manual API references definition, explore our syntax.

Our in-house analytics give you insights into page views, search analytics, session recordings and more. Access these on your dashboard.

We also support integrations with a range of analytics providers. You can find the list of providers here.