Skip to content

Commit ac12771

Browse files
committed
docs: Mintlify CLI, Node LTS note, config filename clarifications
1 parent a50359f commit ac12771

File tree

1 file changed

+10
-10
lines changed

1 file changed

+10
-10
lines changed

README.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -29,37 +29,37 @@ Base Docs are community-managed. We welcome and encourage contributions from eve
2929
3030
## Local development
3131

32-
Prerequisite: Node.js v19+.
32+
Prerequisite: Node.js 18.17+ (LTS recommended). Tested with Node 20/22.
3333

3434
1. Clone the repository.
35-
2. Install the Mint CLI to preview documentation changes locally:
35+
2. Install the Mintlify CLI to preview documentation changes locally:
3636

3737
```bash
38-
npm i -g mint
38+
npm i -g mintlify
3939
```
4040

41-
3. Preview locally (run from the `docs/` directory where `docs.json` lives):
41+
3. Preview locally (run from the `docs/` directory where your Mintlify config (`docs.json` or `mint.json`) lives):
4242

4343
```bash
4444
cd docs
45-
mint dev
45+
npx mintlify dev
4646
```
4747

4848
Alternatively, without a global install:
4949

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

5454
### Troubleshooting
5555

56-
- Ensure Node.js v19+ is installed and that you run `mint dev` from the directory containing `docs.json` (usually `docs/`).
57-
- Local preview differs from production: run `mint update` to update the CLI.
56+
- Ensure Node.js 18.17+ is installed and that you run `npx mintlify dev` from the directory containing your Mintlify config (`docs.json` or `mint.json`) (usually `docs/`).
57+
- Local preview differs from production: run `npx mintlify update` to update the CLI.
5858

5959
## How to contribute
6060

6161
1. **Fork and branch**: Fork `base/docs` and create a descriptive branch for your change.
62-
2. **Edit content in `docs/`**: Follow the structure and style guidelines below. Preview locally with the Mint CLI.
62+
2. **Edit content in `docs/`**: Follow the structure and style guidelines below. Preview locally with the Mintlify CLI.
6363
3. **Open a pull request**: Provide a clear summary and links to related pages. The docs team and community will review.
6464

6565
> Tip: Prefer small, focused PRs. Link related guides and references directly in your content.
@@ -163,4 +163,4 @@ The core team will review opened PRs. The SLA is 2 weeks, generally on a first-c
163163

164164
## Storybook for UI components
165165

166-
See `storybook/README.md` for details on local Storybook and component docs.
166+
See `storybook/README.md` for details on local Storybook and component docs.

0 commit comments

Comments
 (0)