pnpm Workspaces와 Turborepo 기반 Frontend Monorepo 구축을 통한 코드 재사용성 및 빌드 효율 극대화

Context

Polyrepo 구조에서 발생하는 코드 중복과 라이브러리 버전 불일치로 인한 유지보수 비용 증가 문제 발생. 공유 모듈을 npm으로 배포하는 방식은 버전 관리 및 릴리즈 오버헤드를 유발하여 개발 속도를 저하시키는 병목 지점으로 작용.

Technical Solution

• pnpm Workspaces 도입을 통한 단일 리포지토리 내 다중 패키지 관리 체계 구축
• pnpm-workspace.yaml 설정을 통해 apps 및 packages 디렉터리를 구분하여 서비스와 공유 라이브러리의 관심사 분리
• workspace:* 프로토콜 기반의 심볼릭 링크 연결로 물리적 복사 없는 패키지 참조 및 디스크 공간 최적화
• TypeScript 소스 파일 직접 노출 설정을 통한 패키지별 개별 빌드 단계 제거 및 컴파일 효율 개선
• Turborepo의 의존성 그래프 분석 기반 빌드 파이프라인 구축으로 패키지 간 실행 순서 자동 최적화