mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
3ca550b188
* docs: update hosted docs domain to mintlify.site * docs: complete mintlify.site migration across remaining pages Updates 45 files that PR 6282 had originally changed but were reverted by PR 6285 and not re-addressed in this PR: - snippets/vercel-json-generator.mdx (all 4 locales): rewrite destinations now use mintlify.site, consistent with deploy/vercel.mdx - assistant/use.mdx: example deep-link URLs - ai/skillmd.mdx: agent card subdomain reference - guides/assistant-embed.mdx: docsURL code example - guides/codex.mdx: MCP URL example - deploy/authentication-setup.mdx: example Mintlify subdomain - discovery-openapi.json: domain identifier URL descriptions (4 occurrences) - integrations/privacy/osano.mdx: managed rule domain - editor/branching-and-publishing.mdx: branch preview URL format - customize/themes.mdx: theme demo site links - guides/help-center.mdx: live example link - zh/editor/collaborate.mdx: branch preview URL format All changes mirrored across es, fr, and zh locales. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
49 lines
2.4 KiB
Plaintext
49 lines
2.4 KiB
Plaintext
---
|
|
title: "What is Mintlify?"
|
|
description: "Mintlify is a documentation platform designed for developers and AI, with smart search, interactive API playgrounds, and built-in analytics."
|
|
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.site` 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 automations, 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>
|