wehub-resource-sync
4b6817381b
Benchmark image — build + push to ECR (any adapter) / build + push (push) Waiting to run
CI / quality (ubuntu-latest) (push) Waiting to run
CI / test (tools-runtime) (push) Waiting to run
CI / test (e2e-general) (push) Waiting to run
CI / test (cli-runtime) (push) Waiting to run
CI / test (e2e-provider-and-openclaw) (push) Waiting to run
CI / test (integrations-and-misc) (push) Waiting to run
CI / coverage-report (push) Blocked by required conditions
CI / test-kubernetes (push) Waiting to run
CI / should-run-thorough (push) Waiting to run
CI / test-thorough (cloudwatch-demo) (push) Blocked by required conditions
CI / test-thorough (flink-ecs) (push) Blocked by required conditions
CI / test-thorough (upstream-lambda) (push) Blocked by required conditions
CI / test-thorough (prefect-ecs-fargate) (push) Blocked by required conditions
CodeQL / Analyze (python) (push) Waiting to run
Release / build-binaries (zip, opensre.exe, onefile, windows-latest, windows-x64) (push) Blocked by required conditions
Release / publish-release (push) Blocked by required conditions
Release / publish-main-release (push) Blocked by required conditions
Release / prepare (push) Waiting to run
Release / verify (push) Blocked by required conditions
Release / build-python-dist (push) Blocked by required conditions
Release / build-binaries (tar.gz, opensre, onedir, macos-15-intel, darwin-x64) (push) Blocked by required conditions
Release / build-binaries (tar.gz, opensre, onedir, macos-latest, darwin-arm64) (push) Blocked by required conditions
Release / build-binaries (tar.gz, opensre, onedir, ubuntu-22.04, linux-x64) (push) Blocked by required conditions
Release / build-binaries (tar.gz, opensre, onedir, ubuntu-22.04-arm, linux-arm64) (push) Blocked by required conditions
Synthetic Deterministic Tests / Synthetic offline (deterministic) (push) Waiting to run
Interactive Shell Live (PR + post-merge) / turn-checks (no-LLM) (push) Waiting to run
Interactive Shell Live (PR + post-merge) / turn-live shard ${{ matrix.shard_index }} (push) Waiting to run
CI (OpenClaw E2E) / openclaw test (push) Has been cancelled
95 lines
2.7 KiB
Plaintext
95 lines
2.7 KiB
Plaintext
---
|
|
title: 'Development'
|
|
description: 'Preview changes locally to update your docs'
|
|
---
|
|
|
|
<Info>
|
|
**Prerequisites**:
|
|
- Node.js version 19 or higher
|
|
- A docs repository with a `docs.json` file
|
|
</Info>
|
|
|
|
Follow these steps to install and run Mintlify on your operating system.
|
|
|
|
<Steps>
|
|
<Step title="Install the Mintlify CLI">
|
|
|
|
```bash
|
|
npm i -g mint
|
|
```
|
|
</Step>
|
|
|
|
<Step title="Preview locally">
|
|
|
|
Navigate to your docs directory where your `docs.json` file is located, and run the following command:
|
|
|
|
```bash
|
|
mint dev
|
|
```
|
|
|
|
A local preview of your documentation will be available at `http://localhost:3000`.
|
|
|
|
</Step>
|
|
</Steps>
|
|
|
|
## Custom ports
|
|
|
|
By default, Mintlify uses port 3000. You can customize the port Mintlify runs on by using the `--port` flag. For example, to run Mintlify on port 3333, use this command:
|
|
|
|
```bash
|
|
mint dev --port 3333
|
|
```
|
|
|
|
If you attempt to run Mintlify on a port that's already in use, it will use the next available port:
|
|
|
|
```md
|
|
Port 3000 is already in use. Trying 3001 instead.
|
|
```
|
|
|
|
## Mintlify versions
|
|
|
|
Please note that each CLI release is associated with a specific version of Mintlify. If your local preview does not align with the production version, please update the CLI:
|
|
|
|
```bash
|
|
npm mint update
|
|
```
|
|
|
|
## Validating links
|
|
|
|
The CLI can assist with validating links in your documentation. To identify any broken links, use the following command:
|
|
|
|
```bash
|
|
mint broken-links
|
|
```
|
|
|
|
## Deployment
|
|
|
|
If the deployment is successful, you should see the following:
|
|
|
|
<Frame>
|
|
<img src="/images/checks-passed.png" alt="Screenshot of a deployment confirmation message that says All checks have passed." style={{ borderRadius: '0.5rem' }} />
|
|
</Frame>
|
|
|
|
## Code formatting
|
|
|
|
We suggest using extensions on your IDE to recognize and format MDX. If you're a VSCode user, consider the [MDX VSCode extension](https://marketplace.visualstudio.com/items?itemName=unifiedjs.vscode-mdx) for syntax highlighting, and [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode) for code formatting.
|
|
|
|
## Troubleshooting
|
|
|
|
<AccordionGroup>
|
|
<Accordion title='Error: Could not load the "sharp" module using the darwin-arm64 runtime'>
|
|
|
|
This may be due to an outdated version of node. Try the following:
|
|
1. Remove the currently-installed version of the CLI: `npm remove -g mint`
|
|
2. Upgrade to Node v19 or higher.
|
|
3. Reinstall the CLI: `npm i -g mint`
|
|
</Accordion>
|
|
|
|
<Accordion title="Issue: Encountering an unknown error">
|
|
|
|
Solution: Go to the root of your device and delete the `~/.mintlify` folder. Then run `mint dev` again.
|
|
</Accordion>
|
|
</AccordionGroup>
|
|
|
|
Curious about what changed in the latest CLI version? Check out the [CLI changelog](https://www.npmjs.com/package/mintlify?activeTab=versions).
|