Files
mintlify__docs/deploy/monorepo.mdx
mintlify[bot] f8e015ff62 Improve SEO descriptions across 177 pages (#4993)
* Improve SEO metadata: update descriptions to 130-155 chars across 177 pages

Generated-By: mintlify-agent

* Apply suggestion from @ethanpalm

* Apply suggestions from code review

Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>

* 💅

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-03-31 16:12:58 -07:00

44 lines
1.7 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.
## 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. Select the **Set up as monorepo** toggle button.
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. Select **Save changes**.
</Step>
</Steps>