toss/yarn-plugin-catalogs

Yarn 카탈로그를 catalogs.yml 파일로 중앙 관리하고 계층 구조 상속을 지원하는 플러그인

설치형 도구맘대로 써도 됨 · MIT웹·Next.js·풀스택TypeScript난이도
69+0이번 주0 찜
8포크2이슈

중간맛 분석

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의 의존성이 정의된 카탈로그를 올바르게 사용하는지 자동 검증할 때

핵심 기능

catalogs.yml에서 선언적 버전 관리/ 구분자로 카탈로그 계층 상속워크스페이스별 검증 규칙(strict/warn/restrict)

대안 대비 차별점

Yarn의 네이티브 카탈로그 기능(4.10+) 위에 YAML 기반 선언형 관리와 계층 상속을 추가하여, pnpm과 유사한 개발 경험을 Yarn 사용자에게 제공합니다.

준비물

  • Yarn 4.10.0 이상

바로 시작하기

  1. 플러그인 설치하기
yarn plugin import https://raw.githubusercontent.com/toss/yarn-plugin-catalogs/main/bundles/%40yarnpkg/plugin-catalogs.js
  1. 프로젝트 루트에 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
  1. 카탈로그를 .yarnrc.yml에 적용하기
yarn catalogs apply
  1. package.json에서 카탈로그 프로토콜 사용하기
{
  "dependencies": {
    "lodash": "catalog:",
    "react": "catalog:stable",
    "typescript": "catalog:stable/canary"
  }
}​
  1. 종속성 설치하기
yarn install
  1. (선택) CI/CD에서 카탈로그 동기화 확인하기
yarn catalogs apply --check

별 추이 · 7일

69+0 / 7일

활용성 · 따라 만들기 좋은가

샘플 점수 20/100
  • 관대한 라이선스
  • 테스트 있음
  • 예제 디렉토리
  • 최근 활동
  • AGENTS.md
  • llms.txt
  • 템플릿

⚪ 최근 활동 정보 없음 · 2025년 생성

이 레포에 깃밥 배지 달기

[![깃밥](https://www.gitbap.com/badge/toss/yarn-plugin-catalogs.svg)](https://www.gitbap.com/r/toss/yarn-plugin-catalogs)

🔌 클로드에서 바로 써보기

깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.

방법 ① 커넥터 URL

클로드 설정 → 커넥터에 이 주소를 붙여넣기.

https://www.gitbap.com/api/mcp
방법 ② 플러그인 (체험까지)

플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.

/plugin marketplace add jakeparkcolde/gitbap-cowork
/plugin install gitbap-cowork@gitbap
연결 방법 자세히 →

AI가 README 기반으로 요약했습니다 · 원문 보기