---
title: Crafting your repository
description: Design and build your Turborepo.
url: "https://turborepo.dev/docs/crafting-your-repository"
docs_index: /llms.txt
lastUpdated: 2026-10-16
product: turborepo
type: overview
summary: Step-by-step guides for designing, building, and optimizing a monorepo with Turborepo.
related:
  - /docs/crafting-your-repository/structuring-a-repository
  - /docs/core-concepts
---

> For an index of all documentation, see [/llms.txt](/llms.txt).

Architecting a monorepo is a careful process. Through these guides, you'll learn how to design and build a monorepo that will make every team faster - no matter the size.

The guides in this section will take you through building a multi-package workspace, commonly referred to as a monorepo. They are meant to be read in order as they build on top of the knowledge from previous guides, but you can read them in any order or skip to the pages specific to your use case.

By the time you've read through all of this section, you should have a good understanding of how to design and build a monorepo with Turborepo.

> Turborepo can also be used to speed up single-package workspaces. Visit the
> [single-package workspace](/docs/guides/single-package-workspaces) section for
> more information.

## From zero to `turbo`

#### [1. Structuring a repository](/docs/crafting-your-repository/structuring-a-repository)

Design the directory structure of your monorepo.

#### [2. Managing dependencies](/docs/crafting-your-repository/managing-dependencies)

Using dependencies for sharing code

#### [3. Creating an internal package](/docs/crafting-your-repository/creating-an-internal-package)

Make a package in your repository

#### [4. Configuring tasks](/docs/crafting-your-repository/configuring-tasks)

Design your task patterns

#### [5. Running tasks](/docs/crafting-your-repository/running-tasks)

Run tasks as fast as possible

#### [6. Caching](/docs/crafting-your-repository/caching)

Never do the same work twice

#### [7. Developing apps](/docs/crafting-your-repository/developing-applications)

Run many apps in parallel

#### [8. Using environment variables](/docs/crafting-your-repository/using-environment-variables)

Account for variables in your environment

#### [9. Constructing CI](/docs/crafting-your-repository/constructing-ci)

Ship your applications

#### [10. Upgrading](/docs/crafting-your-repository/upgrading)

Upgrading your Turborepo version

#### [11. Understanding your repository](/docs/crafting-your-repository/understanding-your-repository)

Understanding your codebase with Turborepo

## More guides

We also have more guides centered around [specific tools, use cases, and other topics](/docs/guides).

---

For a semantic overview of all documentation, see [/sitemap.md](/sitemap.md)

For an index of all available documentation, see [/llms.txt](/llms.txt)

For agent-facing discovery, including API and MCP surfaces, see [/agents.md](/agents.md)