Streamline release tooling: changesets + pkg.pr.new

.changeset/config.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.1.1/schema.json",
+  "changelog": [
+    "@changesets/changelog-github",
+    { "repo": "storybookjs/addon-designs" }
+  ],
+  "commit": false,
+  "fixed": [],
+  "linked": [],
+  "access": "public",
+  "baseBranch": "master",
+  "updateInternalDependencies": "patch"
+}

.changeset/swift-river-lantern.md

@@ -0,0 +1,5 @@
+---
+"@storybook/addon-designs": patch
+---
+
+Add npm provenance and support Storybook canary releases

.github/workflows/publish-preview.yml

@@ -0,0 +1,36 @@
+name: Publish preview
+
+on:
+  pull_request:
+  push:
+    branches:
+      - master
+
+env:
+  CI: true
+  COREPACK_INTEGRITY_KEYS: 0
+
+jobs:
+  release-preview:
+    name: Publish preview releases
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+
+      - name: Enable corepack (for pnpm)
+        run: corepack enable
+
+      - name: Setup Node.js
+        uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
+        with:
+          cache: pnpm
+          node-version-file: ".nvmrc"
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build
+        run: pnpm --filter @storybook/addon-designs build
+
+      - name: Publish preview releases
+        run: pnpm pkg-pr-new publish --pnpm ./packages/storybook-addon-designs

.github/workflows/release.yml

@@ -1,42 +1,52 @@
 name: Release
 
-on: [push]
+on:
+  push:
+    branches:
+      - master
+
+env:
+  CI: true
+  COREPACK_INTEGRITY_KEYS: 0
 
 permissions:
-  id-token: write # Required for OIDC
-  contents: read
+  contents: write
+  pull-requests: write
+  id-token: write
 
 jobs:
   release:
+    name: Release
     runs-on: ubuntu-latest
-    if: "!contains(github.event.head_commit.message, 'ci skip') && !contains(github.event.head_commit.message, 'skip ci')"
+    if: github.repository == 'storybookjs/addon-designs'
     steps:
-      - name: Checkout
-        uses: actions/checkout@v6
+      - uses: actions/create-github-app-token@67018539274d69449ef7c02e8e71183d1719ab42 # v2.1.4
+        id: app-token
+        with:
+          app-id: ${{ vars.STORYBOOK_BOT_APP_ID }}
+          private-key: ${{ secrets.STORYBOOK_BOT_APP_PRIVATE_KEY }}
+
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
         with:
           fetch-depth: 0
 
-      - name: Use PNPM
-        uses: pnpm/action-setup@v4
+      - name: Enable corepack (for pnpm)
+        run: corepack enable
 
-      - name: Use Node.js 24.x
-        uses: actions/setup-node@v6
+      - name: Setup Node.js
+        uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
         with:
-          node-version-file: .nvmrc
+          cache: pnpm
+          node-version-file: ".nvmrc"
 
       - name: Install dependencies
-        run: pnpm install
+        run: pnpm install --frozen-lockfile
 
-      - name: Build
-        run: |
-          pnpm run build
-
-      - name: No git changes
-        run: |
-          git diff --exit-code
-
-      - name: Create Release
+      - name: Create Release Pull Request or Publish to npm
+        uses: changesets/action@e0145edc7d9d8679003495b11f87bd8ef63c0cba # v1.5.3
+        with:
+          publish: pnpm release
+          commitMode: github-api
         env:
-          GITHUB_TOKEN: ${{ secrets.GH_TOKEN }}
-        run: |
-          pnpm run release
+          GITHUB_TOKEN: ${{ steps.app-token.outputs.token }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}

AGENTS.md

@@ -0,0 +1,38 @@
+# Agent Instructions for addon-designs
+
+Keep this file, `AGENTS.md`, up to date when the repo's release workflow or contributor guidance changes.
+
+This file is the canonical instruction source for coding agents. `CLAUDE.md` points here instead of duplicating instructions.
+
+## Release Process
+
+This repo uses [Changesets](https://github.com/changesets/changesets) for versioning and publishing.
+
+```bash
+pnpm changeset   # Create a changeset for your changes
+pnpm release     # Publish the add-on package (CI handles this automatically)
+```
+
+**Before committing, always run the format script to avoid CI failures:**
+
+```bash
+pnpm fmt
+```
+
+### Creating Changesets (MANDATORY for user-facing changes)
+
+When making changes that affect users (bug fixes, features, breaking changes, dependency updates), you **MUST** create a changeset file.
+
+1. Create a new `.md` file in the `.changeset/` directory
+2. Use the naming convention `<random-word>-<random-word>-<random-word>.md`
+3. Format it like this:
+
+```markdown
+---
+"@storybook/addon-designs": patch
+---
+
+Short description of what changed.
+```
+
+Use `patch` for fixes and non-breaking maintenance changes, `minor` for new backward-compatible features, and `major` for breaking changes.

CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

package.json

@@ -9,28 +9,29 @@
     "dev": "pnpm -r run dev",
     "example": "pnpm --filter examples run storybook",
     "fmt": "prettier --write README.md CHANGELOG.md CONTRIBUTING.md package.json 'packages/**/*.{js,jsx,ts,tsx,md,mdx,json}'",
-    "release": "pnpm --filter @storybook/addon-designs run release"
+    "release": "pnpm --filter @storybook/addon-designs changeset publish"
   },
   "publishConfig": {
     "provenance": true,
     "registry": "https://registry.npmjs.org/"
   },
   "devDependencies": {
-    "@auto-it/released": "^11.3.6",
     "@storybook/addon-designs": "workspace:*",
     "@storybook/addon-docs": "^10.0.0-0",
     "@storybook/react-vite": "^10.0.0-0",
     "@types/react": "^18.2.65",
     "@types/react-dom": "^18.2.21",
-    "auto": "^11.3.6",
     "figma-js": "^1.16.0",
     "prettier": "^3.6.2",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "remark-gfm": "^4.0.0",
     "storybook": "^10.0.0-0",
     "tsup": "^8.0.2",
-    "typescript": "^5.9.2"
+    "typescript": "^5.9.2",
+    "@changesets/changelog-github": "^0.5.1",
+    "@changesets/cli": "^2.29.6",
+    "pkg-pr-new": "^0.0.57"
   },
   "packageManager": "pnpm@10.27.0+sha512.72d699da16b1179c14ba9e64dc71c9a40988cbdc65c264cb0e489db7de917f20dcf4d64d8723625f2969ba52d4b7e2a1170682d9ac2a5dcaeaab732b7e16f04a"
 }