Member-only story

Mono-repos: Part 1. Introduction

Sahu
3 min readJan 22, 2022

--

monorepo v polyrepos — Created with Blender @mrsauravsahu.in on Instagram

Code organisation is one of the biggest discussions in Software. And similar to most things, it is subjective and the TDLR with this post is this — “choose what works well for your team, but don’t be afraid to try out different things.”

In this post, I want to discuss the basics of a mono-repo and why you could consider it over poly-repos.

What are mono-repos?

Stated simply, mono-repos are code repositories which house more than one deployable. These deployables could be an npm package, a web app, a docker image, a helm template, a shell script, etc., or a combination of these.

Also, this means everything in your project is placed in one repository — these include the source code, documentation, supporting examples (postman collections, curl scripts), CI/CD, and the rest.

Why mono-repos?

This is where the discussion starts, and I encourage each one of you to share your thoughts about mono-repos in the comments.

I understand that this is very subjective but let’s try and list out reasons why mono-repos might be a good idea.

Transparency/Openness

The main reason why mono-repos make sense, as everything is in one place, the complete code base, and…

--

--

Sahu
Sahu

Written by Sahu

All opinions shared are personal and not influenced by my Employer • Senior Software Engineer @ McKinsey & Company

No responses yet