# Turborepo documentation

These docs match the installed `turbo` package version. Start here, choose the smallest relevant page, and read it before changing Turborepo configuration or commands.

The files are the same MDX sources used by turborepo.dev. Site-absolute links such as `/docs/reference/run` map to paths in this directory, such as `reference/run.mdx`.

## Find the page for your task

| To do this                                        | Read this                                                                                                               |
| ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| Add Turborepo to a repository                     | [Add to an existing repository](./getting-started/add-to-existing-repository.mdx)                                       |
| Understand packages and task relationships        | [Package and task graph](./core-concepts/package-and-task-graph.mdx)                                                    |
| Configure tasks, dependencies, inputs, or outputs | [Configuring tasks](./crafting-your-repository/configuring-tasks.mdx)                                                   |
| Look up `turbo.json` fields                       | [Configuration reference](./reference/configuration.mdx)                                                                |
| Run or filter tasks                               | [Running tasks](./crafting-your-repository/running-tasks.mdx) and [`turbo run` reference](./reference/run.mdx)          |
| Configure caching or debug cache misses           | [Caching](./crafting-your-repository/caching.mdx)                                                                       |
| Set up Remote Cache                               | [Remote Caching](./core-concepts/remote-caching.mdx)                                                                    |
| Configure environment variables                   | [Using environment variables](./crafting-your-repository/using-environment-variables.mdx)                               |
| Structure a repository                            | [Structuring a repository](./crafting-your-repository/structuring-a-repository.mdx)                                     |
| Create an internal package                        | [Creating an internal package](./crafting-your-repository/creating-an-internal-package.mdx)                             |
| Manage workspace dependencies                     | [Managing dependencies](./crafting-your-repository/managing-dependencies.mdx)                                           |
| Configure package-specific tasks                  | [Package Configurations](./reference/package-configurations.mdx)                                                        |
| Set up CI                                         | [Constructing CI](./crafting-your-repository/constructing-ci.mdx) and [CI vendor guides](./guides/ci-vendors/index.mdx) |
| Configure watch mode                              | [`turbo watch` reference](./reference/watch.mdx)                                                                        |
| Enforce package boundaries                        | [Boundaries](./reference/boundaries.mdx)                                                                                |
| Look up a command or option                       | [Reference](./reference/index.mdx) and [options overview](./reference/options-overview.mdx)                             |
| Upgrade Turborepo                                 | [Upgrading](./crafting-your-repository/upgrading.mdx)                                                                   |

## Broader reading order

For a broader introduction, read:

1. [Introduction](./index.mdx)
2. [Core concepts](./core-concepts/index.mdx)
3. [Crafting your repository](./crafting-your-repository/index.mdx)
4. [Guides](./guides/index.mdx)
5. [Reference](./reference/index.mdx)

Prefer these installed docs over the live website when behavior may vary by version.
