mint 4.2.454 → 4.2.455

package/README.md

@@ -34,66 +34,216 @@
 
 ### Installation
 
-Download the Mint CLI using the following command
-
 ```
 npm i -g mint
 ```
 
-### Development
+Requires Node 20.17 or higher. LTS versions recommended. Node 25+ is not supported.
+
+### Local preview
 
 #### `mint dev`
 
-Run this command at the root of your Mintlify project to preview changes locally.
+Run at the root of your Mintlify project to preview changes locally. Opens in the browser by default.
 
-Notes
+```
+mint dev
+```
 
-- `mint dev` requires Node v19 or higher.
+**Options**
 
-#### Custom Ports
+| Flag | Description | Default |
+|------|-------------|---------|
+| `--port <number>` | Port to run the preview on | `3000` |
+| `--no-open` | Skip opening the preview in the browser | — |
+| `--groups <group...>` | Mock user groups for local testing | — |
+| `--disable-openapi` | Disable OpenAPI file generation | — |
 
-Mintlify uses port 3000 by default. You can use the `--port` flag to customize the port Mintlify runs on. For example, use this command to run in port 3333:
+**Custom port**
 
 ```
 mint dev --port 3333
 ```
 
-You will see an error like this if you try to run Mintlify in a port that's already taken:
+If the specified port is already in use, the CLI automatically tries the next available port.
+
+**Troubleshooting**
+
+If `mint dev` is not working, try these steps in order:
+
+1. Make sure you are running in a folder with a `docs.json` file.
+2. Run `mint update` to get the latest version of the CLI.
+3. Make sure you are using Node 20.17 or higher.
+4. Delete the contents of the `.mintlify` folder in your home directory.
+
+### Validate and check
+
+#### `mint validate`
+
+Validate the documentation build in strict mode. Exits with a non-zero code on any warning or error — useful in CI.
 
 ```
-Error: listen EADDRINUSE: address already in use :::3000
+mint validate
 ```
 
-#### Troubleshooting
+**Options**
 
-Steps you can take if the dev CLI is not working (After each step try to run `mint dev` again):
+| Flag | Description |
+|------|-------------|
+| `--groups <group...>` | Mock user groups for validation |
+| `--disable-openapi` | Disable OpenAPI file generation |
 
-- Make sure you are running in a folder with a `docs.json` file.
-- Run `mint update` to ensure you have the most recent version of the CLI.
-- Make sure you are using Node v19 or higher.
-- Navigate to the `.mintlify` folder in your home directory and delete its contents.
+#### `mint broken-links`
 
-### Additional Commands
+Check for broken internal links in your project.
 
-#### `mint broken-links`
+```
+mint broken-links
+```
+
+**Options**
 
-Check for broken internal links in your Mintlify project.
+| Flag | Description |
+|------|-------------|
+| `--check-anchors` | Also validate anchor links like `link-path#section` against heading slugs |
+| `--check-external` | Also check external links for broken URLs |
+| `--check-snippets` | Also check links inside `<Snippet>` components |
+
+#### `mint openapi-check <filename>`
+
+Check an OpenAPI spec for errors. Accepts a local file path or a URL.
+
+```
+mint openapi-check ./openapi.yaml
+mint openapi-check https://petstore3.swagger.io/api/v3/openapi.json
+```
+
+#### `mint a11y`
+
+Check for accessibility issues in your documentation. Also available as `mint accessibility`, `mint accessibility-check`, and `mint a11y-check`.
+
+```
+mint a11y
+```
+
+**Options**
+
+| Flag | Description |
+|------|-------------|
+| `--skip-contrast` | Skip color contrast checks |
+| `--skip-alt-text` | Skip alt text checks on images and videos |
+
+### Create and manage content
+
+#### `mint new [directory]`
+
+Create a new Mintlify documentation site. Defaults to the current directory.
+
+```
+mint new
+mint new my-docs
+```
+
+**Options**
+
+| Flag | Description |
+|------|-------------|
+| `--theme <name>` | Theme for the documentation site |
+| `--name <name>` | Name of the documentation project |
+| `--force` | Initialize in a non-empty directory |
 
 #### `mint rename <from> <to>`
 
-Rename a file in a Mintlify project and update all internal link references.
+Rename a file and update all internal references to it throughout the project.
+
+```
+mint rename introduction.mdx overview.mdx
+```
+
+**Options**
 
-#### `mint openapi-check <openapiFilenameOrUrl>`
+| Flag | Description |
+|------|-------------|
+| `--force` | Rename files and skip errors |
 
-Check your OpenAPI file for errors. You can pass in a filename (e.g. `./openapi.yaml`) or a URL (e.g. `https://petstore3.swagger.io/api/v3/openapi.json`).
+#### `mint scrape <url>`
 
-#### `mint update`
+Scrape an entire documentation site and convert it to Mintlify MDX files. Also available as `mint scrape site <url>`.
+
+```
+mint scrape https://example.com/docs
+```
+
+**Options**
+
+| Flag | Description |
+|------|-------------|
+| `--filter <path>` | Only scrape URLs matching this path (e.g. `/docs` matches `/docs` and `/docs/*`) |
+
+#### `mint scrape page <url>`
+
+Scrape a single documentation page and convert it to an MDX file.
+
+```
+mint scrape page https://example.com/docs/introduction
+```
+
+#### `mint scrape openapi <location>`
+
+Generate MDX files from an OpenAPI spec. Accepts a local file path or a URL.
+
+```
+mint scrape openapi ./openapi.yaml
+mint scrape openapi https://petstore3.swagger.io/api/v3/openapi.json
+```
+
+**Options**
 
-Updates to the most recent version of the Mint CLI.
+| Flag | Description | Default |
+|------|-------------|---------|
+| `--outDir <path>` | Folder to write the generated files | — |
+| `--overwrite` | Overwrite existing files | `false` |
+
+#### `mint migrate-mdx`
+
+Migrate MDX OpenAPI endpoint pages to `x-mint` extensions and `docs.json`.
 
 #### `mint upgrade`
 
-Upgrade from `mint.json` to `docs.json`. This command creates a `docs.json` from your existing `mint.json`.
+Upgrade `mint.json` to `docs.json`. Creates a `docs.json` from your existing `mint.json`.
+
+#### `mint workflow`
+
+Add a workflow to your documentation repository.
+
+### Export
+
+#### `mint export`
+
+Export a static site as a zip file for air-gapped deployment.
+
+```
+mint export
+mint export --output docs.zip
+```
+
+**Options**
+
+| Flag | Description | Default |
+|------|-------------|---------|
+| `--output <path>` | Output zip file path | `export.zip` |
+| `--groups <group...>` | Mock user groups for export | — |
+| `--disable-openapi` | Disable OpenAPI file generation | — |
+
+### CLI management
+
+#### `mint update`
+
+Update the CLI to the latest version.
+
+#### `mint version`
+
+Display the current version of the CLI and client. Also available as `mint v`.
 
 ### Get Started
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mint",
-  "version": "4.2.454",
+  "version": "4.2.455",
   "description": "The Mintlify CLI",
   "engines": {
     "node": ">=18.0.0"
@@ -30,10 +30,10 @@
     "clean:all": "rimraf node_modules"
   },
   "dependencies": {
-    "@mintlify/cli": "4.0.1057"
+    "@mintlify/cli": "4.0.1058"
   },
   "devDependencies": {
     "rimraf": "5.0.1"
   },
-  "gitHead": "689313194fd46d5dd2211b59062a041ba91f3981"
+  "gitHead": "449627f27a66da94b3f6a851601ac2524ad1b71a"
 }