Monorepo vs multi-repo decision in Git - When to Use Which

The Big Idea

What if your team could stop wasting hours fixing code conflicts and start building faster together?

The Scenario

Imagine you work on a big project with many teams, each building different parts. Everyone stores their code in separate folders on their computers, sharing files by emailing or copying manually.

The Problem

This manual way is slow and confusing. People overwrite each other's work, lose track of changes, and spend hours fixing mistakes. It's hard to know which version is the latest or how parts fit together.

The Solution

Using a clear decision between monorepo and multi-repo setups helps organize code smartly. A monorepo keeps all code in one place, making sharing and syncing easy. Multi-repos separate projects, giving teams independence and simpler history.

Before vs After

✗ Before

TeamA edits fileA; TeamB edits fileB; share by email or USB.

✓ After

Monorepo: all code in one repo; Multi-repo: separate repos per project.

What It Enables

Choosing the right repo strategy lets teams work faster, avoid conflicts, and deliver better software together.

Real Life Example

A company building a mobile app and a website decides to use a monorepo so both teams can share code easily and release updates together without confusion.

Key Takeaways

Manual code sharing causes confusion and errors.

Monorepo centralizes code for easy collaboration.

Multi-repo gives teams independence and clear boundaries.

Practice

1. Which of the following best describes a monorepo in Git?

easy

A. A repository used only for backups

B. Multiple repositories each containing one project

C. A repository that only stores documentation

D. A single repository containing multiple projects together

Solution

1. Step 1: Understand the definition of monorepo

   A monorepo is a single repository that holds multiple projects or components together in one place.

2. Step 2: Compare with other options

   The other options describe different repository setups or uses, not monorepos.

3. Final Answer:

   A single repository containing multiple projects together -> Option D

4. Quick Check:

   Monorepo = single repo for many projects [OK]

Hint: Monorepo means one repo for many projects [OK]

Common Mistakes:

• Confusing monorepo with multi-repo
• Thinking monorepo is only for documentation
• Assuming monorepo means backup repo

2. Which Git command is commonly used to clone a multi-repo project?

easy

A. git merge

B. git clone

C. git init

D. git push

Solution

1. Step 1: Identify the command to copy a repository locally

   The git clone command copies a remote repository to your local machine.

2. Step 2: Check other commands for correctness

   git merge combines branches, git init creates a new repo, and git push uploads changes.

3. Final Answer:

   git clone <repo-url> -> Option B

4. Quick Check:

   Clone = copy repo locally [OK]

Hint: Clone to copy repo locally, not merge or push [OK]

Common Mistakes:

• Using git merge to copy repo
• Confusing git init with cloning
• Trying to push before cloning

3. You have a monorepo with two projects: frontend and backend. You run git status inside the frontend folder after changing a file in backend. What will you see?

medium

A. Error message about folder mismatch

B. No changes detected because you are inside frontend folder

C. Changes detected for the backend file because monorepo tracks all files

D. Only staged changes shown

Solution

1. Step 1: Understand monorepo file tracking

   In a monorepo, Git tracks all files in the single repository regardless of folder location.

2. Step 2: Effect of running git status in a subfolder

   Running git status anywhere in the repo shows changes in the entire repo, including backend files.

3. Final Answer:

   Changes detected for the backend file because monorepo tracks all files -> Option C

4. Quick Check:

   Monorepo tracks all files, status shows all changes [OK]

Hint: Monorepo status shows all changes, no matter folder [OK]

Common Mistakes:

• Thinking git status is folder-limited
• Expecting error when running git status in subfolder
• Confusing staged changes with all changes

4. A team using multi-repos notices frequent conflicts when updating shared libraries. What is a likely cause?

medium

A. Lack of centralized codebase causes version mismatches

B. Using monorepo causes conflicts

C. Git does not support multiple repositories

D. Developers forgot to commit changes

Solution

1. Step 1: Analyze multi-repo challenges

   Multi-repos separate projects, so shared libraries can have different versions causing conflicts.

2. Step 2: Eliminate incorrect options

   Monorepo is not used here, Git supports multiple repos, and forgetting commits is unrelated to shared library conflicts.

3. Final Answer:

   Lack of centralized codebase causes version mismatches -> Option A

4. Quick Check:

   Multi-repo can cause version conflicts without central code [OK]

Hint: Multi-repo can cause version conflicts without central code [OK]

Common Mistakes:

• Blaming monorepo for multi-repo issues
• Thinking Git can't handle multiple repos
• Ignoring version mismatch as cause

5. Your team has 5 small independent projects with different release schedules and teams. Which repo strategy fits best and why?

hard

A. Multi-repo, because it allows independent work and releases

B. Multi-repo, because it merges all projects into one

C. Monorepo, because it forces all teams to work together

D. Monorepo, because it simplifies dependency management

Solution

1. Step 1: Analyze project independence and release schedules

   Independent projects with different schedules benefit from separate repos to avoid interference.

2. Step 2: Match repo strategy to team needs

   Multi-repo allows teams to work independently and release on their own timelines.

3. Final Answer:

   Multi-repo, because it allows independent work and releases -> Option A

4. Quick Check:

   Independent projects = multi-repo best fit [OK]

Hint: Independent projects with different schedules use multi-repo [OK]

Common Mistakes:

• Choosing monorepo for independent projects
• Thinking monorepo forces independence
• Confusing multi-repo with merging projects