03 — Changesets로 SemVer 자동화: snapshot·prerelease·publish

pnpm add -D -w @changesets/cli
pnpm changeset init

{
  "$schema": "https://unpkg.com/@changesets/config@3.0.0/schema.json",
  "changelog": [
    "@changesets/changelog-github",
    { "repo": "org/design-system" }
  ],
  "commit": false,
  "fixed": [],
  "linked": [
    ["@org/react", "@org/tailwind-preset", "@org/panda-preset"]
  ],
  "access": "public",
  "baseBranch": "main",
  "updateInternalDependencies": "patch",
  "ignore": ["@org/docs"],
  "snapshot": {
    "useCalculatedVersion": true,
    "prereleaseTemplate": "{tag}-{datetime}"
  }
}

pnpm changeset

🦋  Which packages would you like to include? (Use arrow keys/space)
  ◯ @org/tokens
  ◉ @org/react
  ◯ @org/icons

🦋  Which packages should have a major bump?
  ◯ @org/react

🦋  Which packages should have a minor bump?
  ◉ @org/react

🦋  Please enter a summary for this change:
  > Button: size prop "xl" 추가

---
"@org/react": minor
---
 
Button: size prop "xl" 추가
 
- 새로운 `size="xl"` 옵션
- BREAKING이 아닌 추가만

name: Release
 
on:
  push:
    branches:
      - main
 
concurrency: ${{ github.workflow }}-${{ github.ref }}
 
jobs:
  release:
    name: Release
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
      id-token: write   # npm provenance
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
 
      - uses: pnpm/action-setup@v4
        with:
          version: 9
 
      - uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: pnpm
          registry-url: https://registry.npmjs.org
 
      - run: pnpm install --frozen-lockfile
      - run: pnpm turbo run build typecheck test
 
      - name: Create Release PR or Publish
        id: changesets
        uses: changesets/action@v1
        with:
          publish: pnpm release
          version: pnpm version-packages
          commit: "chore: version packages"
          title: "chore: version packages"
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
          NPM_CONFIG_PROVENANCE: true

{
  "scripts": {
    "version-packages": "changeset version && pnpm install --no-frozen-lockfile",
    "release": "pnpm turbo run build && changeset publish"
  }
}

# @org/react
 
## 1.2.0
 
### Minor Changes
 
- abc1234: Button: size prop "xl" 추가 ([#142](https://github.com/org/ds/pull/142))
 
### Patch Changes
 
- Updated dependencies [def5678]
  - @org/tokens@1.1.1

# PR 브랜치에서
pnpm changeset version --snapshot pr-142
pnpm changeset publish --tag pr-142 --no-git-tag

pnpm add @org/react@pr-142

# .github/workflows/snapshot.yml
on:
  pull_request:
    types: [labeled]
 
jobs:
  snapshot:
    if: github.event.label.name == 'snapshot'
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: pnpm install --frozen-lockfile
      - run: pnpm turbo run build
      - run: |
          pnpm changeset version --snapshot pr-${{ github.event.pull_request.number }}
          pnpm changeset publish --tag pr-${{ github.event.pull_request.number }} --no-git-tag
      - uses: actions/github-script@v7
        with:
          script: |
            github.rest.issues.createComment({
              issue_number: context.issue.number,
              owner: context.repo.owner,
              repo: context.repo.repo,
              body: '📦 Snapshot published: `pnpm add @org/react@pr-${{ github.event.pull_request.number }}`'
            })

pnpm changeset pre enter next
# 이제 모든 publish가 2.0.0-next.0, 2.0.0-next.1, ... 로 나감
 
# 평소처럼 작업
pnpm changeset
git commit ...
# main 머지 → 자동으로 2.0.0-next.X publish
 
# 모두 끝나면 종료
pnpm changeset pre exit
# 다음 publish는 2.0.0 정식

pnpm add @org/react@next   # prerelease 채널
pnpm add @org/react@latest # 안정 채널 (기본)

- name: Check for changesets
  run: |
    if [ -z "$(ls -A .changeset/*.md 2>/dev/null | grep -v README)" ]; then
      echo "No changeset found. Run 'pnpm changeset' or add 'no-changeset' label."
      exit 1
    fi