mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
f14cca3b52
* Standardize style: 'Click' to 'Select' for Mintlify UI; split long sentences Generated-By: mintlify-agent * Revert 'select' back to 'click' for UI interactions Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * Fix select→click for UI elements across docs Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
59 lines
2.0 KiB
Plaintext
59 lines
2.0 KiB
Plaintext
---
|
|
title: "Monorepo setup"
|
|
description: "Configure the documentation path and content directory in a monorepo project so Mintlify deploys only from your designated docs folder."
|
|
keywords: ["monorepo", "content directory", "multi-project repository"]
|
|
---
|
|
|
|
Configure Mintlify to deploy documentation from a specific directory within a monorepo. This setup allows you to maintain documentation alongside your code in repositories that contain multiple projects or services.
|
|
|
|
A typical monorepo structure might look like this:
|
|
|
|
```text
|
|
your-repo/
|
|
├── apps/
|
|
│ ├── web/
|
|
│ └── api/
|
|
├── docs/
|
|
│ ├── docs.json
|
|
│ └── quickstart.mdx
|
|
└── package.json
|
|
```
|
|
|
|
In this example, you'd set your documentation path to `/docs`.
|
|
|
|
## Prerequisites
|
|
|
|
* Admin access to your Mintlify project.
|
|
* Documentation files organized in a dedicated directory within your monorepo.
|
|
* A valid `docs.json` in your documentation directory.
|
|
|
|
## Configure monorepo deployment
|
|
|
|
<Steps>
|
|
<Step title="Access Git settings">
|
|
Navigate to [Git Settings](https://dashboard.mintlify.com/settings/deployment/git-settings) in your dashboard.
|
|
|
|
<Frame>
|
|
<img
|
|
className="block dark:hidden my-0 pointer-events-none"
|
|
src="/images/monorepo-light.png"
|
|
alt="The project settings panel in the Git Settings menu. The Set up as monorepo toggle button is enabled and a path to the /docs directory is specified."
|
|
/>
|
|
<img
|
|
className="hidden dark:block my-0 pointer-events-none"
|
|
src="/images/monorepo-dark.png"
|
|
alt="The project settings panel in the Git Settings menu. The Set up as monorepo toggle button is enabled and a path to the /docs directory is specified."
|
|
/>
|
|
</Frame>
|
|
|
|
</Step>
|
|
<Step title="Set your documentation path">
|
|
1. Click the **Set up as monorepo** toggle.
|
|
2. Enter the relative path to your docs directory. For example, if your docs are in the `docs` directory, enter `/docs`.
|
|
<Note>
|
|
Do not include a trailing slash in the path.
|
|
</Note>
|
|
3. Click **Save changes**.
|
|
</Step>
|
|
</Steps>
|