You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: api-playground/openapi/setup.mdx
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,7 +9,7 @@ To describe your endpoints with OpenAPI, make sure you have a valid OpenAPI
9
9
document in either JSON or YAML format that follows the
10
10
[OpenAPI specification](https://swagger.io/specification/). Your document must
11
11
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>
Copy file name to clipboardExpand all lines: installation.mdx
+20-20Lines changed: 20 additions & 20 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,48 +17,48 @@ icon: "terminal"
17
17
**Prerequisite**: Please install [Node.js](https://nodejs.org/en) (version 19 or higher) before proceeding.
18
18
</Info>
19
19
20
-
**Step 1**: Install the Mintlify CLI:
20
+
**Step 1**: Install the Mint CLI:
21
21
22
22
<CodeGroup>
23
23
24
24
```bash npm
25
-
npm i -g mintlify
25
+
npm i -g mint
26
26
```
27
27
28
28
29
29
```bash yarn
30
-
yarn global add mintlify
30
+
yarn global add mint
31
31
```
32
32
33
33
34
34
```bash pnpm
35
-
pnpm add -g mintlify
35
+
pnpm add -g mint
36
36
```
37
37
38
38
</CodeGroup>
39
39
40
40
**Step 2**: Navigate to the docs directory (where the `docs.json` file is located) and execute the following command:
41
41
42
42
```bash
43
-
mintlify dev
43
+
mint dev
44
44
```
45
45
46
46
Alternatively, if you do not want to install the CLI globally, you can use a run a one-time script:
47
47
48
48
<CodeGroup>
49
49
50
50
```bash npm
51
-
npx mintlify dev
51
+
npx mint dev
52
52
```
53
53
54
54
55
55
```bash yarn
56
-
yarn dlx mintlify dev
56
+
yarn dlx mint dev
57
57
```
58
58
59
59
60
60
```bash pnpm
61
-
pnpm dlx mintlify dev
61
+
pnpm dlx mint dev
62
62
```
63
63
64
64
</CodeGroup>
@@ -67,22 +67,22 @@ A local preview of your documentation will be available at `http://localhost:300
67
67
68
68
## Updates
69
69
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:
71
71
72
72
<CodeGroup>
73
73
74
74
```bash npm
75
-
npm i -g mintlify@latest
75
+
npm i -g mint@latest
76
76
```
77
77
78
78
79
79
```bash yarn
80
-
yarn global upgrade mintlify
80
+
yarn global upgrade mint
81
81
```
82
82
83
83
84
84
```bash pnpm
85
-
pnpm up --global mintlify
85
+
pnpm up --global mint
86
86
```
87
87
88
88
</CodeGroup>
@@ -92,7 +92,7 @@ pnpm up --global mintlify
92
92
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:
93
93
94
94
```bash
95
-
mintlify dev --port 3333
95
+
mint dev --port 3333
96
96
```
97
97
98
98
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.
103
103
104
104
## Additional Commands
105
105
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.
107
107
108
108
### Find Broken Links
109
109
110
110
The CLI can assist with validating reference links made in your documentation. To identify any broken links, use the following command:
111
111
112
112
```bash
113
-
mintlify broken-links
113
+
mint broken-links
114
114
```
115
115
116
116
### Check OpenAPI Spec
117
117
118
118
You can use the CLI to check your OpenAPI file for errors using the following command:
119
119
120
120
```bash
121
-
mintlify openapi-check <openapiFilenameOrUrl>
121
+
mint openapi-check <openapiFilenameOrUrl>
122
122
```
123
123
124
124
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
128
128
You can rename files using the following command:
129
129
130
130
```bash
131
-
mintlify rename <oldFilename><newFilename>
131
+
mint rename <oldFilename><newFilename>
132
132
```
133
133
134
134
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
147
147
<Accordiontitle='Error: Could not load the "sharp" module using the darwin-arm64 runtime'>
148
148
This may be due to an outdated version of node. Try the following:
149
149
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`
151
151
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`
153
153
</Accordion>
154
154
<Accordiontitle="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.
Copy file name to clipboardExpand all lines: quickstart.mdx
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -54,17 +54,17 @@ To work locally with your documentation, install the Mintlify Command Line Inter
54
54
<CodeGroup>
55
55
56
56
```bash npm
57
-
npm install -g mintlify
57
+
npm install -g mint
58
58
```
59
59
60
60
61
61
```bash yarn
62
-
yarn global add mintlify
62
+
yarn global add mint
63
63
```
64
64
65
65
66
66
```bash pnpm
67
-
pnpm add -g mintlify
67
+
pnpm add -g mint
68
68
```
69
69
70
70
</CodeGroup>
@@ -117,7 +117,7 @@ description: "This is the introduction to the documentation"
117
117
To preview the changes locally, run the following command.
118
118
119
119
```bash
120
-
mintlify dev
120
+
mint dev
121
121
```
122
122
123
123
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
227
227
228
228
<AccordionGroup>
229
229
<Accordiontitle="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.
231
231
</Accordion>
232
232
<Accordiontitle="Changes not reflecting on live site">
233
233
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.
0 commit comments