# Monorepo setup (/deploy/monorepo)

<!-- agent-signals: reading_time_min: 1 · est_tokens: 545 · updated: 2026-07-30 -->
Related: [Authentication setup](/deploy/authentication-setup.md), [CI checks](/deploy/ci.md), [Custom developer portals](/deploy/custom-portal.md), [Deployments](/deploy/deployments.md), [Offline export](/deploy/export.md), [GitHub Enterprise Server](/deploy/ghes.md)

Configure Mintlify to deploy documentation from a specific directory within a monorepo. This setup lets you maintain documentation alongside your code in repositories that contain multiple projects or services.

<Note>
  A monorepo deployment uses a single repository with a subdirectory of docs. To combine content from more than one repository into one site, see [Multi-repository deployments](/deploy/multi-repo).
</Note>

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 [#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 [#configure-monorepo-deployment]

<Steps>
  <Step title="Access Git settings">
    Navigate to [Git Settings](https://app.mintlify.com/settings/deployment/git-settings) in your dashboard.

    <Frame>
      <img className="block dark:hidden my-0 pointer-events-none" src="/_assets/e290b5878af258c5c5993e3776da7d45ca622b7b05e1c3e00ba3a39c0c178210" alt="The project settings panel in the Git Settings menu, showing the docs.json is in a subdirectory toggle enabled and a path to the /docs directory specified." />

      <img className="hidden dark:block my-0 pointer-events-none" src="/_assets/ce9cfe28d31b3a9342d387e4c4dc161132c677d1653b465d2a14e7bd84873857" alt="The project settings panel in the Git Settings menu, showing the docs.json is in a subdirectory toggle enabled and a path to the /docs directory specified." />
    </Frame>
  </Step>

  <Step title="Set your documentation path">
    1. Enable the **docs.json is in a subdirectory** 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**. Saving triggers a new deployment from the configured path.
  </Step>
</Steps>