Read Anthropic’s case study about Graphite Reviewer

Monorepos

Greg Foster
Greg Foster
Graphite software engineer


Note

This guide explains this concept in vanilla Git. For Graphite documentation, see our CLI docs.


A monorepo, or mono repository, is a development strategy where code for many projects is stored in the same repository. While these projects are often related, they are usually independently deployable and developed by different teams. Monorepos allow for simplified dependency management, a single source of truth for all projects, and facilitate collaboration across different teams by providing visibility into each other's code.

A monorepohttps://en.wikipedia.org/wiki/Monorepo , or mono repository, is a development strategy where code for many projects is stored in the same repository. While these projects are often related, they are usually independently deployable and developed by different teams. Monorepos allow for simplified dependency management, a single source of truth for all projects, and facilitate collaboration across different teams by providing visibility into each other's code.

Monorepos are not a new concept in software development. They have been around for decades, with large organizations like Google and Facebook using them to manage their vast codebases. The evolution of monorepos can be linked to the need for more efficient collaboration and code reuse among developers in large-scale software projects. The growth of microservices and the need to manage dependencies more effectively have also contributed to the increased popularity of monorepos.

The benefits of using a monorepo include:

Common misconceptions about monorepos include the belief that they are the same as monolithic applications. However, a monorepo refers to the version control strategy, not the architectural style of the software. Monorepos can pose challenges such as:

  • Scalability Issues: As the size of the monorepo grows, it can become difficult to manage without the proper tooling and infrastructure.

  • Increased Build Times: A large monorepo can lead to longer build times unless strategies like caching and selective testing are implemented.

Several high-profile companies have successfully implemented monorepos. Google, for instance, has a monorepo that includes over 2 billion lines of code and is managed with a custom version control system and build tools. Twitter, Facebook, and Airbnb also use monorepos for various aspects of their development operations, leveraging monorepo-specific tools to handle potential challenges effectively.

A monorepo, or monolithic repository, is a version control strategy where a single repository contains multiple projects or codebases, which may be unrelated or functionally distinct.

Companies like Google and Facebook prefer monorepos because they aid agile development, allow easy code sharing, and enable engineers to move freely between projects. Monorepos can also be more compatible with the dynamic nature of large organizations and projects.

Yes, monorepos can handle multiple languages and tools. The use of containerization allows each microservice to be built into its own container image and deployed independently, mitigating the difficulties in creating a uniform build process.

Not inherently. While monorepos make it easy to share code, disciplined software engineering practices are required to maintain loosely-coupled, independently deployable units.

Monorepos can simplify dependency management by using one universal version number for all projects, ensuring the repository is always in a consistent state. Dependencies are still specified in the build system but do not require separate version numbers for each project.

Yes, there are several tools designed to handle monorepos efficiently, including Bazel, Buck, Pants, and others. These tools can manage complex dependencies and provide fast, incremental builds.

Monorepos allow for atomic commits across multiple projects, making it easier to refactor APIs and their callers in one commit, as opposed to coordinating changes across multiple repositories.

Adopting a monorepo can be challenging due to the potential for complicated merge conflicts, the need for scalable source control management, and the complexity of deployment processes. However, with the right tools and practices, these challenges can be managed effectively.

CI/CD pipelines can be integrated with monorepos to automatically build, test, and deploy individual microservices within the larger codebase. Containerization also allows for independent deployment and testing of microservices.

Deciding on a monorepo approach should consider your team’s culture and discipline. It's crucial to evaluate whether your team can collaborate effectively within a monorepo structure and maintain loosely-coupled code.

For smaller companies, monorepos can present challenges such as the inability to apply role-based access controls to parts of the repository or difficulty in open-sourcing specific parts of the codebase. However, these downsides are often outweighed by the simplification of project organization, easier navigation, and streamlined build and test setups.

Graphite
Git stacked on GitHub

Stacked pull requests are easier to read, easier to write, and easier to manage.
Teams that stack ship better software, faster.

Or install our CLI.
Product Screenshot 1
Product Screenshot 2