Skip to content

Commit 55a0384

Browse files
committed
Use mint CLI
1 parent 0ec8721 commit 55a0384

File tree

8 files changed

+33
-33
lines changed

8 files changed

+33
-33
lines changed

.github/workflows/check-links.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,6 @@ jobs:
1313
with:
1414
node-version: "latest"
1515
- name: Install Mintlify CLI
16-
run: npm i -g mintlify
16+
run: npm i -g mint
1717
- name: Run broken link checker
18-
run: mintlify broken-links
18+
run: mint broken-links

api-playground/openapi/setup.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ To describe your endpoints with OpenAPI, make sure you have a valid OpenAPI
99
document in either JSON or YAML format that follows the
1010
[OpenAPI specification](https://swagger.io/specification/). Your document must
1111
follow OpenAPI specification 3.0+.
12-
<Tip>To validate your OpenAPI spec, use our [CLI](https://www.npmjs.com/package/mintlify) and run this command: <br/>`mintlify openapi-check <openapiFilenameOrUrl>`</Tip>
12+
<Tip>To validate your OpenAPI spec, use our [CLI](https://www.npmjs.com/package/mint) and run this command: <br/>`mint openapi-check <openapiFilenameOrUrl>`</Tip>
1313

1414
## Auto-populate API pages
1515

api-playground/troubleshooting.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ Here's a list of common issues we've seen customers run into:
1212
In this scenario, it's likely that either Mintlify cannot find your OpenAPI document,
1313
or your OpenAPI document is invalid.
1414

15-
Running `mintlify dev` locally should reveal some of these issues.
15+
Running `mint dev` locally should reveal some of these issues.
1616

1717
To verify your OpenAPI document will pass validation:
1818

changelog.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -86,13 +86,13 @@ mode: "center"
8686
1. Make sure your CLI is the latest version
8787

8888
```
89-
npm i mintlify@latest -g
89+
npm i mint@latest -g
9090
```
9191

9292
1. In your docs repository, run
9393

9494
```
95-
mintlify upgrade
95+
mint upgrade
9696
```
9797

9898
1. Delete your old mint.json file and push your changes

installation.mdx

Lines changed: 20 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -17,48 +17,48 @@ icon: "terminal"
1717
**Prerequisite**: Please install [Node.js](https://nodejs.org/en) (version 19 or higher) before proceeding.
1818
</Info>
1919

20-
**Step 1**: Install the Mintlify CLI:
20+
**Step 1**: Install the Mint CLI:
2121

2222
<CodeGroup>
2323

2424
```bash npm
25-
npm i -g mintlify
25+
npm i -g mint
2626
```
2727

2828

2929
```bash yarn
30-
yarn global add mintlify
30+
yarn global add mint
3131
```
3232

3333

3434
```bash pnpm
35-
pnpm add -g mintlify
35+
pnpm add -g mint
3636
```
3737

3838
</CodeGroup>
3939

4040
**Step 2**: Navigate to the docs directory (where the `docs.json` file is located) and execute the following command:
4141

4242
```bash
43-
mintlify dev
43+
mint dev
4444
```
4545

4646
Alternatively, if you do not want to install the CLI globally, you can use a run a one-time script:
4747

4848
<CodeGroup>
4949

5050
```bash npm
51-
npx mintlify dev
51+
npx mint dev
5252
```
5353

5454

5555
```bash yarn
56-
yarn dlx mintlify dev
56+
yarn dlx mint dev
5757
```
5858

5959

6060
```bash pnpm
61-
pnpm dlx mintlify dev
61+
pnpm dlx mint dev
6262
```
6363

6464
</CodeGroup>
@@ -67,22 +67,22 @@ A local preview of your documentation will be available at `http://localhost:300
6767

6868
## Updates
6969

70-
Each CLI release is associated with a specific version of Mintlify. If your local preview doesn't align with the production version, please update the CLI:
70+
Each CLI release is associated with a specific version of the Mintlify platform. If your local preview doesn't align with the production version, please update the CLI:
7171

7272
<CodeGroup>
7373

7474
```bash npm
75-
npm i -g mintlify@latest
75+
npm i -g mint@latest
7676
```
7777

7878

7979
```bash yarn
80-
yarn global upgrade mintlify
80+
yarn global upgrade mint
8181
```
8282

8383

8484
```bash pnpm
85-
pnpm up --global mintlify
85+
pnpm up --global mint
8686
```
8787

8888
</CodeGroup>
@@ -92,7 +92,7 @@ pnpm up --global mintlify
9292
By default, the CLI uses port 3000. You can customize the port using the `--port` flag. To run the CLI on port 3333, for instance, use this command:
9393

9494
```bash
95-
mintlify dev --port 3333
95+
mint dev --port 3333
9696
```
9797

9898
If you attempt to run on a port that's already in use, it will use the next available port:
@@ -103,22 +103,22 @@ Port 3000 is already in use. Trying 3001 instead.
103103

104104
## Additional Commands
105105

106-
While `mintlify dev` is the most commonly used command, there are other commands you can use to manage your documentation.
106+
While `mint dev` is the most commonly used command, there are other commands you can use to manage your documentation.
107107

108108
### Find Broken Links
109109

110110
The CLI can assist with validating reference links made in your documentation. To identify any broken links, use the following command:
111111

112112
```bash
113-
mintlify broken-links
113+
mint broken-links
114114
```
115115

116116
### Check OpenAPI Spec
117117

118118
You can use the CLI to check your OpenAPI file for errors using the following command:
119119

120120
```bash
121-
mintlify openapi-check <openapiFilenameOrUrl>
121+
mint openapi-check <openapiFilenameOrUrl>
122122
```
123123

124124
You can pass in a filename (e.g. `./openapi.yaml`) or a URL (e.g. `https://petstore3.swagger.io/api/v3/openapi.json`).
@@ -128,7 +128,7 @@ You can pass in a filename (e.g. `./openapi.yaml`) or a URL (e.g. `https://petst
128128
You can rename files using the following command:
129129

130130
```bash
131-
mintlify rename <oldFilename> <newFilename>
131+
mint rename <oldFilename> <newFilename>
132132
```
133133

134134
This is an improvement over updating the filename normally as it will also update all references to the file, ensuring no broken links.
@@ -147,11 +147,11 @@ If you use JetBrains, we recommend the [MDX IntelliJ IDEA plugin](https://plugin
147147
<Accordion title='Error: Could not load the "sharp" module using the darwin-arm64 runtime'>
148148
This may be due to an outdated version of node. Try the following:
149149

150-
1. Remove the currently-installed version of mintlify: `npm remove -g mintlify`
150+
1. Remove the currently-installed version of the mint CLI: `npm remove -g mint`
151151
2. Upgrade to Node v19 or higher.
152-
3. Reinstall mintlify: `npm install -g mintlify`
152+
3. Reinstall the mint CLI: `npm install -g mint`
153153
</Accordion>
154154
<Accordion title="Issue: Encountering an unknown error">
155-
Solution: Go to the root of your device and delete the ~/.mintlify folder. Afterwards, run `mintlify dev` again.
155+
Solution: Go to the root of your device and delete the ~/.mintlify folder. Afterwards, run `mint dev` again.
156156
</Accordion>
157157
</AccordionGroup>

pages.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -133,7 +133,7 @@ in any page.
133133
```jsx
134134
---
135135
title: "Page that goes to external link"
136-
url: "https://www.npmjs.com/package/mintlify"
136+
url: "https://www.npmjs.com/package/mint"
137137
---
138138
```
139139

quickstart.mdx

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -54,17 +54,17 @@ To work locally with your documentation, install the Mintlify Command Line Inter
5454
<CodeGroup>
5555

5656
```bash npm
57-
npm install -g mintlify
57+
npm install -g mint
5858
```
5959

6060

6161
```bash yarn
62-
yarn global add mintlify
62+
yarn global add mint
6363
```
6464

6565

6666
```bash pnpm
67-
pnpm add -g mintlify
67+
pnpm add -g mint
6868
```
6969

7070
</CodeGroup>
@@ -117,7 +117,7 @@ description: "This is the introduction to the documentation"
117117
To preview the changes locally, run the following command.
118118

119119
```bash
120-
mintlify dev
120+
mint dev
121121
```
122122

123123
Your preview will be available at `localhost:3000`.
@@ -227,7 +227,7 @@ If you encounter any issues during the setup process, check our common troublesh
227227

228228
<AccordionGroup>
229229
<Accordion title="Local preview not working">
230-
Make sure you have Node.js v19+ installed and that you're running the `mintlify dev` command from the directory containing your `docs.json` file.
230+
Make sure you have Node.js v19+ installed and that you're running the `mint dev` command from the directory containing your `docs.json` file.
231231
</Accordion>
232232
<Accordion title="Changes not reflecting on live site">
233233
Deployment can take upwards to a few minutes. Check your GitHub Actions (for code-based workflow) or deployment logs in the Mintlify dashboard to ensure there are no build errors.

settings/broken-links.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ When you change the path of a file in your docs folder, it will also change the
1111
Catch broken links with our CLI. Simply [install the CLI](/installation) and run the command:
1212

1313
```bash
14-
mintlify broken-links
14+
mint broken-links
1515
```
1616

1717
The CLI will identify any relative links in your docs that don't exist.

0 commit comments

Comments
 (0)