📦 Monorepo란? - Polyrepo와 비교해보기

프로젝트를 시작하면서 pnpm + Turborepo 기반 모노레포 구조를 선택했다.
Monorepo의 개념과 Polyrepo와의 차이를 정리해보려고 한다.

📚 Reference

🧩 코드를 어떻게 나누어 관리할 것인가 - 이게 레포지토리 전략의 핵심이다.

전략	설명
모노리스(Monolith)	하나의 프로젝트 안에 모든 코드가 강하게 결합되어 있어 분리가 어려운 구조
폴리레포(Polyrepo)	서비스·패키지마다 각각 별도 레포지토리를 생성하여 독립적으로 운영
모노레포(Monorepo)	하나의 레포지토리 안에 여러 패키지를 독립적인 경계로 나누어 관리

Monorepo ≠ Monolith

Monorepo란?

모노레포는 단일 저장소(Monolithic Repository)의 약자로, 두 개 이상의 프로젝트를 하나의 레포지토리에서 함께 관리하는 전략이다.

단순히 폴더를 한데 모아두는 것이 아니라, 다음과 같은 관리의 효율성을 목적으로 한다.

코드 재사용성 극대화: 여러 서비스에서 공통으로 사용하는 UI, utils 등을 별도의 배포 과정 없이 바로 참조할 수 있다.
원자적 커밋 (Atomic Commits): 공통 라이브러리의 인터페이스를 변경할 때, 이를 사용하는 모든 서비스의 코드를 한 번의 PR로 수정할 수 있어 버전 불일치로 인한 런타임 에러를 방지한다.
일관된 개발 환경: ESLint, Prettier 설정 등을 최상위에서 한 번만 관리하면 모든 하위 프로젝트에 동일하게 적용된다.

CI/CD 복잡도와 빌드 시간: 저장소가 커질수록 전체 빌드 시간이 늘어날 수 있다. 따라서 Turborepo나 Nx 같은 도구를 사용하여 변경 사항이 있는 패키지만 선별적으로 빌드하는 전략이 필수적이다.
러닝 커브: 초반 환경 구축에 시간이 다소 소요될 수 있다.
의존성 오염: 특정 프로젝트에만 필요한 의존성이 루트에 설치되어 다른 프로젝트에 영향을 주지 않도록 주의가 필요하다.

🪺 워크스페이스란?

pnpm, yarn 등 패키지 매니저에서 제공하는 기능으로, 하나의 레포지토리 안에서 여러 package.json을 가진 폴더들을 개별 패키지로 인식하게 해준다. 이를 통해 내부 패키지를 마치 외부 라이브러리처럼 import해서 쓸 수 있다.

Polyrepo(Multi-repo)는 프로젝트마다 저장소를 따로 관리하는 전통적인 방식이다.
각 서비스(User, Admin, API 등)는 자신만의 독립적인 생명주기를 가진다.