Monorepo

핵심 개념

Workspace

하나의 저장소 안에 존재하는 여러 서브 프로젝트(패키지)들의 묶음으로, 공통 설정과 의존성을 함께 관리한다.

Package

워크스페이스를 구성하는 개별 단위로, 각자 독립적인 기능이나 배포 대상을 가진 하나의 서브 프로젝트를 의미한다.

Shared Dependency

여러 서브 프로젝트가 공통으로 사용하는 라이브러리나 코드로, 모노레포에서는 이를 한 곳에서 관리해 중복과 버전 불일치를 줄인다.

Build Orchestration

여러 패키지 간의 의존 관계를 파악해 빌드·테스트 순서를 자동으로 결정하고 실행하는 과정이다.

Task Runner / Cache

변경된 패키지만 골라 빌드·테스트를 다시 실행하고 결과를 캐시해 반복 작업을 줄여주는 도구 기능이다.

기본 워크스페이스 설정 예시

루트 package.json에서 workspaces 필드로 하위 packages 디렉터리의 모든 서브 프로젝트를 하나의 워크스페이스로 묶어 관리한다.

{
  "name": "my-monorepo",
  "private": true,
  "workspaces": [
    "packages/*"
  ],
  "scripts": {
    "build": "npm run build --workspaces",
    "test": "npm run test --workspaces"
  }
}