mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
Ethan Palm
814d31888d
* update docs.json * add what is Mintlify? page * add diagram * can't use root
49 lines
2.4 KiB
Plaintext
49 lines
2.4 KiB
Plaintext
---
|
|
title: "What is Mintlify?"
|
|
description: "Mintlify is a knowledge platform for hosting information designed for people and AI."
|
|
keywords: ["overview", "how it works", "architecture"]
|
|
---
|
|
|
|
Mintlify hosts your content as a website. Your content lives in a Git repository as MDX files, and Mintlify builds and deploys your site automatically when you push a change.
|
|
|
|
## The three parts of a Mintlify project
|
|
|
|
**Your repository** is the source of truth for your documentation. It contains an MDX file for every page and a `docs.json` file that configures your site's navigation, theme, and settings. You can use your own GitHub or GitLab repository, or let Mintlify create one for you during onboarding.
|
|
|
|
**The Mintlify dashboard** connects to your repository and lets you manage your site. Use it to monitor deployments, configure settings, manage your team, and edit content directly in the browser.
|
|
|
|
**Your site** powered by Mintlify. Mintlify builds your site from your repository and deploys it at a `.mintlify.app` URL by default. When you're ready, you can point a custom domain to your site.
|
|
|
|
```mermaid
|
|
flowchart LR
|
|
WE["Web editor"] --> Repo[("Git repository")]
|
|
Local["Local editor"] --> Repo
|
|
Repo -- "Webhook" --> Build["Mintlify build"]
|
|
Build --> Site["Live site"]
|
|
```
|
|
|
|
## Editing content
|
|
|
|
There are two ways to edit your content, and you can switch between them freely.
|
|
|
|
- **Web editor**: Edit and publish pages in your browser. The editor commits changes back to your Git repository automatically.
|
|
- **CLI and local editor**: Clone your repository, run `mint dev` to preview your site locally, then push changes to deploy.
|
|
|
|
Multiple team members can work in either workflow at the same time, using Git branches to manage parallel changes. Anyone who can push to your repository can update your content.
|
|
|
|
## AI features
|
|
|
|
Built-in AI features help people and AI find and understand your content, and help you maintain your content.
|
|
|
|
The **assistant** lets your users ask questions and get cited answers from your content.
|
|
|
|
The **agent** helps your team create and maintain content by generating updates from scheduled workflows, pull requests merging in your feature repository, or Slack threads.
|
|
|
|
See [AI-native documentation](/ai-native) for an overview of all AI features.
|
|
|
|
## Next steps
|
|
|
|
<Card title="Quickstart" icon="rocket" horizontal href="/quickstart">
|
|
Deploy your first documentation site in minutes.
|
|
</Card>
|