Yarn 카탈로그를 catalogs.yml 파일로 중앙 관리하고 계층 구조 상속을 지원하는 플러그인
중간맛 분석
TypeScript 기반 Yarn 플러그인으로, Yarn 4.10.0 이상이 필요합니다. catalogs.yml에서 버전을 정의하면 yarn catalogs apply 명령으로 .yarnrc.yml을 자동 생성하고, 패키지.json에서 catalog: 프로토콜로 참조하게 합니다. 계층 상속(stable/canary는 stable을 상속), 자동 적용(yarn add 시 기본 카탈로그 자동 선택), 검증 기능(/에서 카탈로그 동기화 확인)이 기본 제공됩니다.
이런 레포예요
이럴 때 쓰면 좋아요
- 모노레포에서 모든 워크스페이스의 라이브러리 버전을 한 곳에서 통일하고 싶을 때
- 버전별 카탈로그(stable, beta, canary)를 상속 관계로 정의하고 각 팀/프로젝트에 맞춰 사용할 때
- CI/CD 파이프라인에서 package.json의 의존성이 정의된 카탈로그를 올바르게 사용하는지 자동 검증할 때
핵심 기능
대안 대비 차별점
Yarn의 네이티브 카탈로그 기능(4.10+) 위에 YAML 기반 선언형 관리와 계층 상속을 추가하여, pnpm과 유사한 개발 경험을 Yarn 사용자에게 제공합니다.
먹어본 사람들
실제로 차려 먹어본 손님들의 흔적이에요 — 한마디와 완주 인증 모두 검수 후 공개돼요.
이 레포, 해먹는 법
처음 오셨어요? 어렵지 않아요 — 위에서 아래로 따라 하면 내 컴퓨터에 이 레포를 차려서 바로 맛볼 수 있어요.
준비물
- Yarn 4.10.0 이상
바로 차려먹기Node.js (yarn)
깃밥이 레포 구조를 확인하고 만든 실행 명령이에요. 터미널에 붙여넣으면 받기부터 실행까지 한 번에 진행돼요.
git clone --depth 1 https://github.com/toss/yarn-plugin-catalogs.git && cd yarn-plugin-catalogs && yarn
실행 명령은 README를 확인하세요.
코드는 내 컴퓨터에서 실행돼요 — 처음 보는 레포라면 내용을 한번 훑어보고 실행하는 습관을 추천해요.
README가 안내하는 자세한 단계 보기
- 플러그인 설치하기
yarn plugin import https://raw.githubusercontent.com/toss/yarn-plugin-catalogs/main/bundles/%40yarnpkg/plugin-catalogs.js
- 프로젝트 루트에 catalogs.yml 생성하기
# catalogs.yml
options:
default: [stable]
list:
root:
lodash: npm:4.17.21
stable:
react: npm:18.0.0
typescript: npm:5.1.0
stable/canary:
react: npm:18.2.0
- 카탈로그를 .yarnrc.yml에 적용하기
yarn catalogs apply
- package.json에서 카탈로그 프로토콜 사용하기
{
"dependencies": {
"lodash": "catalog:",
"react": "catalog:stable",
"typescript": "catalog:stable/canary"
}
}
- 종속성 설치하기
yarn install
- (선택) CI/CD에서 카탈로그 동기화 확인하기
yarn catalogs apply --check
깃밥트라이로 맛보기
받아보기 귀찮고 살짝 불안했다면 — 안전 스캔부터 설치까지 터미널 한 줄로 끝나요.
터미널에 붙여넣으면 깃밥 안전 스캔 → 격리 폴더 clone → 설치 → 실행법 안내까지 자동이에요. 처음이어도 괜찮아요 — 이 한 줄이 전부예요.
npx gitbap-try toss/yarn-plugin-catalogs
Node.js만 있으면 설치 없이 실행돼요 · 깃밥트라이가 뭐예요? →
별 추이 · 7일
활용성 · 따라 만들기 좋은가
- 관대한 라이선스
- 테스트 있음
- 예제 디렉토리
- 최근 활동
- AGENTS.md
- llms.txt
- 템플릿
⚪ 최근 활동 정보 없음 · 2025년 생성
「웹·Next.js·풀스택」 이런 레포, 매주 받아보실래요?
매주 월요일 아침, 골라 담은 밥상만. 광고 없이 · 언제든 해지.
내 레포인가요? README에 깃밥 배지 달기
[](https://www.gitbap.com/r/toss/yarn-plugin-catalogs)🔌 클로드에서 바로 써보기 — 깃밥 연결하는 법
깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.
클로드 설정 → 커넥터에 이 주소를 붙여넣기.
https://www.gitbap.com/api/mcp플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI가 README 기반으로 요약했습니다 · 원문 보기