switch node package manager yarn -> pnpm

.cursor/rules/opentrons-ai-client_protocol-designer_react-component.mdc

@@ -145,7 +145,7 @@ Example prompt template:
    This monorepo uses Stylelint. The configuration file is located at the root as .stylelintrc.js.
    To run linting on a specific file, use the following command:
    ```shell
-   yarn stylelint opentrons-ai-client/src/file_path
+   pnpm stylelint opentrons-ai-client/src/file_path
    ```
 
 ## TypeScript Best Practices
@@ -330,13 +330,13 @@ it('should handle empty data', () => {
 To run tests for a specific file (assuming the current directory is the project root), use:
 
 ```shell
-yarn vitest opentrons-ai-client/src/file_path
+pnpm vitest opentrons-ai-client/src/file_path
 ```
 
 To run multiple tests within a folder, use:
 
 ```shell
-yarn vitest opentrons-ai-client/src/folder_path
+pnpm vitest opentrons-ai-client/src/folder_path
 ```
 
 1. **Props Pattern:**

.github/actions/js/setup/action.yml

@@ -1,7 +1,7 @@
 name: 'Setup JS Environment'
 description: >
   Composite action to fix tag handling in checkout,
-  setup Node.js, install udev for USB detection, cache Yarn/NPM caches,
+  setup Node.js, install udev for USB detection, cache PNPM/NPM caches,
   and perform JS setup.
 
 inputs: {}
@@ -11,11 +11,19 @@ runs:
   steps:
     - uses: ./.github/actions/git/resolve-tag
     - uses: ./.github/actions/environment/complex-variables
+
+    # 1. Install pnpm explicitly (Must be BEFORE Setup Node)
+    - name: Install pnpm
+      uses: pnpm/action-setup@v4
+      with:
+        version: 10.22.0
+
+    # 2. Setup Node with pnpm caching enabled
     - name: 'Setup Node'
       uses: actions/setup-node@v4
       with:
         node-version: '22.12.0'
-        cache: 'yarn'
+        cache: 'pnpm' # This works now because pnpm is installed
 
     - name: 'Setup Python'
       uses: actions/setup-python@v4
@@ -27,7 +35,7 @@ runs:
       uses: actions/cache@v4
       with:
         path: ~/.cache/Cypress
-        key: cypress-${{ runner.os }}-${{ hashFiles('**/yarn.lock') }}
+        key: cypress-${{ runner.os }}-${{ hashFiles('**/pnpm-lock.yaml') }}
 
     - name: 'Install udev for USB-detection'
       if: runner.os == 'Linux'
@@ -37,15 +45,24 @@ runs:
     - name: 'Setup JS'
       shell: bash
       run: |
-        # Set up Cypress to download from package-mirror
-        CYPRESS_VERSION=$(grep '"cypress"' package.json | sed 's/.*"cypress": *"\([^"]*\)".*/\1/' | tr -d ' \n\r\t')
+        # 3. Use Node to safely parse package.json (better than grep)
+        CYPRESS_VERSION=$(node -p "try { require('./package.json').devDependencies.cypress } catch(e) { require('./package.json').dependencies.cypress }")
+
+        # Verify version was found
+        if [ -z "$CYPRESS_VERSION" ] || [ "$CYPRESS_VERSION" == "undefined" ]; then
+          echo "Error: Could not detect Cypress version from package.json"
+          exit 1
+        fi
+
         if [[ "$RUNNER_OS" == "Linux" ]]; then
           PLATFORM="linux-x64"
         elif [[ "$RUNNER_OS" == "macOS" ]]; then
           PLATFORM="darwin-x64"
         else
           PLATFORM="win32-x64"
         fi
+
         export CYPRESS_INSTALL_BINARY="https://github.com/Opentrons/package-mirror/releases/download/cypress-${CYPRESS_VERSION}/cypress-${CYPRESS_VERSION}-${PLATFORM}.zip"
 
+        # 4. Run the make target (Ensure this runs 'pnpm install' in your Makefile)
         make setup-js

.github/actions/odd-resource-analysis/package.json

@@ -17,6 +17,6 @@
   },
   "devDependencies": {
     "@vercel/ncc": "0.38.3",
-    "prettier": "2.7.1"
+    "prettier": "3.6.2"
   }
 }

.github/instructions/analyses-snapshot-testing.instructions.md

@@ -203,7 +203,7 @@ Add this label to a PR to automatically:
 
 - **Python 3.10+**
 - **uv** package manager (https://github.com/astral-sh/uv)
-- **Node.js/yarn** (for prettier formatting)
+- **Node.js/pnpm** (for prettier formatting)
 
 ### Initial Setup
 

.github/workflows/app-test-build-deploy.yaml

@@ -15,7 +15,7 @@ on:
       - '*.js'
       - 'scripts/**'
       - '*.json'
-      - 'yarn.lock'
+      - 'pnpm-lock.yaml'
       - '.github/workflows/app-test-build-deploy.yaml'
       - '.github/workflows/utils.js'
       - 'vitest.config.*'
@@ -35,7 +35,7 @@ on:
       - 'discovery-client/**'
       - '*.js'
       - '*.json'
-      - 'yarn.lock'
+      - 'pnpm-lock.yaml'
       - 'scripts/**'
       - '.vitest.config.*'
   workflow_dispatch: {}

.github/workflows/g-code-testing-lint-test.yaml

@@ -66,18 +66,16 @@ jobs:
       - uses: './.github/actions/python/setup'
         with:
           project: 'g-code-testing'
-      - name: 'cache yarn cache'
+      - name: 'cache pnpm cache'
         uses: actions/cache@v4
         with:
           path: |
             ${{ github.workspace }}/.npm-cache/_prebuild
-            ${{ github.workspace }}/.yarn-cache
-          key: js-${{ secrets.GH_CACHE_VERSION }}-${{ runner.os }}-yarn-${{ hashFiles('yarn.lock') }}
+            ${{ github.workspace }}/.pnpm-cache
+          key: js-${{ secrets.GH_CACHE_VERSION }}-${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }}
       - name: 'setup-js'
-        run: |
-          npm config set cache ${{ github.workspace }}/.npm-cache
-          yarn config set cache-folder ${{ github.workspace }}/.yarn-cache
-          make setup-js
+        id: 'setup-js'
+        uses: ./.github/actions/js/setup
       - name: Lint
         run: make -C g-code-testing lint
       - name: Test

.github/workflows/js-check.yaml

@@ -64,23 +64,24 @@ jobs:
           # WORKAROUND: Remove microsoft debian repo due to https://github.com/microsoft/linux-package-repositories/issues/130. Remove line below after it is resolved
           sudo rm -f /etc/apt/sources.list.d/microsoft-prod.list
           sudo apt-get update && sudo apt-get install libudev-dev
-      - name: 'cache yarn cache'
+      - name: 'cache pnpm cache'
         uses: actions/cache@v4
         with:
           path: |
-            ${{ github.workspace }}/.yarn-cache
+            ${{ github.workspace }}/.pnpm-cache
             ${{ github.workspace }}/.npm-cache
-          key: js-${{ secrets.GH_CACHE_VERSION }}-${{ runner.os }}-yarn-${{ hashFiles('yarn.lock') }}
+          key: js-${{ secrets.GH_CACHE_VERSION }}-${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }}
           restore-keys: |
-            js-${{ secrets.GH_CACHE_VERSION }}-${{ runner.os }}-yarn-
+            js-${{ secrets.GH_CACHE_VERSION }}-${{ runner.os }}-pnpm-
       - name: 'setup-js'
         id: 'setup-js'
-        run: |
-          npm config set cache ${{ github.workspace }}/.npm-cache
-          yarn config set cache-folder ${{ github.workspace }}/.yarn-cache
-          make setup-js
+        uses: ./.github/actions/js/setup
+        # run: |
+        #   npm config set cache ${{ github.workspace }}/.npm-cache
+        #   pnpm config set cache ${{ github.workspace }}/.pnpm-cache
+        #   make setup-js
         # Use the if to run all the lint checks even of some fail
-        shell: bash
+        # shell: bash
       - name: 'typechecks'
         if: always() && steps.setup-js.outcome == 'success'
         run: make check-js
@@ -97,4 +98,4 @@ jobs:
         if: always() && steps.setup-js.outcome == 'success'
         run: make lint-css
       - name: 'test scripts'
-        run: yarn vitest scripts
+        run: pnpm vitest scripts

.github/workflows/ll-test-build-deploy.yaml

@@ -222,4 +222,4 @@ jobs:
         with:
           status: 'cancelled'
           workflow_name: 'Labware Library test, build, and deploy'
-          webhook_url: ${{ secrets.OT_APP_RELEASE_SLACK_NOTIFICATION_WEBHOOK_URL }}
+          webhook_url: ${{ secrets.OT_APP_RELEASE_SLACK_NOTIFICATION_WEBHOOK_URL }}

.github/workflows/opentrons-ai-client-staging-continuous-deploy.yaml

@@ -40,17 +40,17 @@ jobs:
           script: |
             const { buildComplexEnvVars } = require(`${process.env.GITHUB_WORKSPACE}/.github/workflows/utils.js`)
             buildComplexEnvVars(core, context)
-      - name: 'cache yarn cache'
+      - name: 'cache pnpm cache'
         uses: actions/cache@v4
         with:
           path: |
             ${{ github.workspace }}/.npm-cache/_prebuild
-            ${{ github.workspace }}/.yarn-cache
-          key: js-${{ secrets.GH_CACHE_VERSION }}-${{ runner.os }}-yarn-${{ hashFiles('yarn.lock') }}
+            ${{ github.workspace }}/.pnpm-cache
+          key: js-${{ secrets.GH_CACHE_VERSION }}-${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }}
       - name: 'setup-js'
         run: |
           npm config set cache ${{ github.workspace }}/.npm-cache
-          yarn config set cache-folder ${{ github.workspace }}/.yarn-cache
+          pnpm config set cache ${{ github.workspace }}/.pnpm-cache
           make setup-js
       - name: 'build'
         env:

.github/workflows/opentrons-ai-client-test.yaml

@@ -57,18 +57,17 @@ jobs:
           script: |
             const { buildComplexEnvVars } = require(`${process.env.GITHUB_WORKSPACE}/.github/workflows/utils.js`)
             buildComplexEnvVars(core, context)
-      - name: 'cache yarn cache'
+      - name: 'cache pnpm cache'
         uses: actions/cache@v4
         with:
           path: |
             ${{ github.workspace }}/.npm-cache/_prebuild
-            ${{ github.workspace }}/.yarn-cache
-          key: js-${{ secrets.GH_CACHE_VERSION }}-${{ runner.os }}-yarn-${{ hashFiles('yarn.lock') }}
+            ${{ github.workspace }}/.pnpm-cache
+          key: js-${{ secrets.GH_CACHE_VERSION }}-${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }}
       - name: 'setup-js'
-        run: |
-          npm config set cache ${{ github.workspace }}/.npm-cache
-          yarn config set cache-folder ${{ github.workspace }}/.yarn-cache
-          make setup-js
+        id: 'setup-js'
+        uses: ./.github/actions/js/setup
+
       - name: 'test frontend packages'
         run: |
           make -C opentrons-ai-client test-cov

.github/workflows/opentrons-ai-production-deploy.yaml

@@ -39,17 +39,17 @@ jobs:
           script: |
             const { buildComplexEnvVars } = require(`${process.env.GITHUB_WORKSPACE}/.github/workflows/utils.js`)
             buildComplexEnvVars(core, context)
-      - name: 'cache yarn cache'
+      - name: 'cache pnpm cache'
         uses: actions/cache@v4
         with:
           path: |
             ${{ github.workspace }}/.npm-cache/_prebuild
-            ${{ github.workspace }}/.yarn-cache
-          key: js-${{ secrets.GH_CACHE_VERSION }}-${{ runner.os }}-yarn-${{ hashFiles('yarn.lock') }}
+            ${{ github.workspace }}/.pnpm-cache
+          key: js-${{ secrets.GH_CACHE_VERSION }}-${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }}
       - name: 'setup-js'
         run: |
           npm config set cache ${{ github.workspace }}/.npm-cache
-          yarn config set cache-folder ${{ github.workspace }}/.yarn-cache
+          pnpm config set cache ${{ github.workspace }}/.pnpm-cache
           make setup-js
       - name: 'build'
         env:

.github/workflows/react-api-client-test.yaml

@@ -47,20 +47,18 @@ jobs:
           # WORKAROUND: Remove microsoft debian repo due to https://github.com/microsoft/linux-package-repositories/issues/130. Remove line below after it is resolved
           sudo rm -f /etc/apt/sources.list.d/microsoft-prod.list
           sudo apt-get update && sudo apt-get install libudev-dev
-      - name: 'cache yarn cache'
+      - name: 'cache pnpm cache'
         uses: actions/cache@v4
         with:
           path: |
-            ${{ github.workspace }}/.yarn-cache
+            ${{ github.workspace }}/.pnpm-cache
             ${{ github.workspace }}/.npm-cache
-          key: js-${{ secrets.GH_CACHE_VERSION }}-${{ runner.os }}-yarn-${{ hashFiles('yarn.lock') }}
+          key: js-${{ secrets.GH_CACHE_VERSION }}-${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }}
           restore-keys: |
-            js-${{ secrets.GH_CACHE_VERSION }}-${{ runner.os }}-yarn-
+            js-${{ secrets.GH_CACHE_VERSION }}-${{ runner.os }}-pnpm-
       - name: 'setup-js'
-        run: |
-          npm config set cache ./.npm-cache
-          yarn config set cache-folder ./.yarn-cache
-          make setup-js
+        id: 'setup-js'
+        uses: ./.github/actions/js/setup
       - name: 'run api-client and react-api-client unit tests'
         run: make -C api-client test-cov
       - name: 'Upload coverage report'

.github/workflows/shared-data-test-lint-deploy.yaml

@@ -126,20 +126,18 @@ jobs:
           # WORKAROUND: Remove microsoft debian repo due to https://github.com/microsoft/linux-package-repositories/issues/130. Remove line below after it is resolved
           sudo rm -f /etc/apt/sources.list.d/microsoft-prod.list
           sudo apt-get update && sudo apt-get install libudev-dev
-      - name: 'cache yarn cache'
+      - name: 'cache pnpm cache'
         uses: actions/cache@v4
         with:
           path: |
-            ${{ github.workspace }}/.yarn-cache
+            ${{ github.workspace }}/.pnpm-cache
             ${{ github.workspace }}/.npm-cache
-          key: js-${{ secrets.GH_CACHE_VERSION }}-${{ runner.os }}-yarn-${{ hashFiles('yarn.lock') }}
+          key: js-${{ secrets.GH_CACHE_VERSION }}-${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }}
           restore-keys: |
-            js-${{ secrets.GH_CACHE_VERSION }}-${{ runner.os }}-yarn-
+            js-${{ secrets.GH_CACHE_VERSION }}-${{ runner.os }}-pnpm-
       - name: 'js deps'
-        run: |
-          npm config set cache ./.npm-cache
-          yarn config set cache-folder ./.yarn-cache
-          make setup-js
+        id: 'setup-js'
+        uses: ./.github/actions/js/setup
       - name: 'run shared-data JS unit tests'
         run: make -C shared-data test-cov
       - name: 'Upload coverage report'
@@ -220,7 +218,7 @@ jobs:
           elif [ "${{ format('{0}', startsWith(github.ref, 'refs/tags/components')) }}" = "true" ] ; then
             echo "Publishing builds for components@ tags"
             echo 'should_publish=true' >> $GITHUB_OUTPUT
-          else 
+          else
             echo "No publish for ref ${{github.ref}} and event ${{github.event_type}}"
             echo 'should_publish=false' >> $GITHUB_OUTPUT
           fi
@@ -247,20 +245,18 @@ jobs:
           # WORKAROUND: Remove microsoft debian repo due to https://github.com/microsoft/linux-package-repositories/issues/130. Remove line below after it is resolved
           sudo rm -f /etc/apt/sources.list.d/microsoft-prod.list
           sudo apt-get update && sudo apt-get install libudev-dev
-      - name: 'cache yarn cache'
+      - name: 'cache pnpm cache'
         uses: actions/cache@v4
         with:
           path: |
-            ${{ github.workspace }}/.yarn-cache
+            ${{ github.workspace }}/.pnpm-cache
             ${{ github.workspace }}/.npm-cache
-          key: js-${{ secrets.GH_CACHE_VERSION }}-${{ runner.os }}-yarn-${{ hashFiles('yarn.lock') }}
+          key: js-${{ secrets.GH_CACHE_VERSION }}-${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }}
           restore-keys: |
-            js-${{ secrets.GH_CACHE_VERSION }}-${{ runner.os }}-yarn-
+            js-${{ secrets.GH_CACHE_VERSION }}-${{ runner.os }}-pnpm-
       - name: 'js deps'
-        run: |
-          npm config set cache ./.npm-cache
-          yarn config set cache-folder ./.yarn-cache
-          make setup-js
+        id: 'setup-js'
+        uses: ./.github/actions/js/setup
       - name: 'build typescript'
         run: make build-ts
       - name: 'build library'

.github/workflows/tag-releases.yaml

@@ -25,18 +25,18 @@ jobs:
       - uses: 'actions/setup-node@v6'
         with:
           node-version: '22.12.0'
-      - name: 'cache yarn cache'
+      - name: 'cache pnpm cache'
         uses: actions/cache@v4
         with:
           path: |
             ${{ github.workspace }}/.npm-cache/_prebuild
-            ${{ github.workspace }}/.yarn-cache
-          key: js-${{ hashFiles('yarn.lock') }}
+            ${{ github.workspace }}/.pnpm-cache
+          key: js-${{ hashFiles('pnpm-lock.yaml') }}
       - name: 'setup-js'
         run: |
           npm config set cache ${{ github.workspace }}/.npm-cache
-          yarn config set cache-folder ${{ github.workspace }}/.yarn-cache
-          yarn install
+          pnpm config set cache ${{ github.workspace }}/.pnpm-cache
+          pnpm install
 
       - name: 'create release'
         run: |