mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
d6960c72bf
* Improve SEO metadata: fix titles, descriptions, and remove redundant OpenAPI descriptions - Remove description frontmatter from 19 API pages where the OpenAPI spec already supplies the description - Fix 2 titles that exceeded 60 characters (content-templates, content-types) - Improve 15 descriptions that were too short (<130 chars) or too long (>160 chars) to target 130-155 characters - All descriptions are unique and include relevant search terms Generated-By: mintlify-agent * re-add API descriptions * Apply suggestion from @ethanpalm * Apply suggestion from @ethanpalm * Apply suggestion from @ethanpalm * Apply suggestion from @ethanpalm --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
80 lines
2.1 KiB
Plaintext
80 lines
2.1 KiB
Plaintext
---
|
|
title: "Preview locally"
|
|
description: "Run a local preview of your Mintlify documentation site with live reload, full-text search, and AI assistant support using mint dev."
|
|
keywords: ["mint dev", "local preview", "localhost", "mint login", "search", "assistant"]
|
|
---
|
|
|
|
## Start the local preview
|
|
|
|
Navigate to your documentation directory containing your `docs.json` file and run:
|
|
|
|
```bash
|
|
mint dev
|
|
```
|
|
|
|
The local preview starts at `http://localhost:3000`. As you edit, changes appear in real time.
|
|
|
|
By default, the preview opens automatically in your browser. To prevent the browser from opening, use the `--no-open` flag:
|
|
|
|
```bash
|
|
mint dev --no-open
|
|
```
|
|
|
|
To generate a preview without installing the CLI globally, run:
|
|
|
|
```bash
|
|
npx mint dev
|
|
```
|
|
|
|
## Log in for search and assistant
|
|
|
|
You must authenticate the CLI with your Mintlify account to enable search and the [assistant](/ai/assistant).
|
|
|
|
```bash
|
|
mint login
|
|
```
|
|
|
|
After you authenticate with the `mint login` command, the CLI stores your credentials in `~/.config/mintlify/config.json` so you stay logged in across sessions. The CLI also prompts you to select a default project, which commands like `mint analytics` use.
|
|
|
|
Once logged in, run `mint dev` to start the local preview with search and the assistant enabled. The assistant uses the same indexed content as your deployed documentation site.
|
|
|
|
To check your authentication status, run:
|
|
|
|
```bash
|
|
mint status
|
|
```
|
|
|
|
To log out, run:
|
|
|
|
```bash
|
|
mint logout
|
|
```
|
|
|
|
## Custom ports
|
|
|
|
By default, the CLI uses port 3000. To use a different port, use the `--port` flag:
|
|
|
|
```bash
|
|
mint dev --port 3333
|
|
```
|
|
|
|
If the port is already in use, the CLI automatically tries the next available port.
|
|
|
|
## Skip OpenAPI processing
|
|
|
|
If you have many OpenAPI files, skip OpenAPI processing during local development to improve performance with the `--disable-openapi` flag:
|
|
|
|
```bash
|
|
mint dev --disable-openapi
|
|
```
|
|
|
|
## Preview as a specific group
|
|
|
|
If you use group-based access control, preview as a specific authentication group with the `--groups` flag:
|
|
|
|
```bash
|
|
mint dev --groups admin
|
|
```
|
|
|
|
See [Authentication setup](/deploy/authentication-setup#control-access-with-groups) for more information on groups.
|