YARN_UPDATE.md

What is this?

This document explains how to manage the repository-pinned Yarn version.

Table of Contents ᐞ

• What is this?
  • Table of Contents
  • Overview
  • Check Current State
  • Upgrade Yarn
  • What Changes on Upgrade
  • Implementation Details
  • Manual Commands
  • Troubleshooting
    • Latest Stable Cannot Be Resolved
    • Version Mismatch
    • Confirm Project Pin
  • Related Docs

Overview ᐞ

This project pins Yarn in-repo so development, CI, and Docker use the same version.

Pinned Yarn is defined by:

• package.json field packageManager
• .yarnrc.yml field yarnPath
• checked-in release file in .yarn/releases/

Check Current State ᐞ

make yarn-status

This prints:

• configured Yarn version
• active Yarn version
• latest stable Yarn Berry version
• update availability status

Dry-run check with no file changes:

make yarn-upgrade-check

Upgrade Yarn ᐞ

Use explicit version:

make yarn-upgrade VERSION=4.17.0

Use compatible alias:

make yarn upgrade VERSION=4.17.0

Use latest stable automatically:

make yarn-upgrade

What Changes on Upgrade ᐞ

Expected changed files:

• package.json
• .yarnrc.yml
• .yarn/releases/yarn-<version>.cjs

Implementation Details ᐞ

Make targets call these scripts:

• scripts/yarn-lib.sh
• scripts/yarn-status.sh
• scripts/yarn-upgrade.sh
• scripts/yarn-upgrade-check.sh

Upgrade flow:

1. update packageManager in package.json
2. run yarn set version to update .yarnrc.yml and release file
3. run corepack prepare yarn@<version> --activate

Manual Commands ᐞ

npm pkg set packageManager="yarn@4.17.0"
yarn set version "4.17.0"
corepack prepare "yarn@4.17.0" --activate

Troubleshooting ᐞ

Latest Stable Cannot Be Resolved ᐞ

If latest lookup fails, use an explicit version:

make yarn-upgrade VERSION=4.17.0

Version Mismatch ᐞ

If configured and active differ, run:

make yarn-upgrade
make yarn-status

Confirm Project Pin ᐞ

node -p "require('./package.json').packageManager"
grep "yarnPath:" .yarnrc.yml
ls -1 .yarn/releases/

Related Docs ᐞ

• doc/YARN_UPDATE_QUICK_REF.md
• doc/YARN_UPDATE_SETUP.md
• doc/README.md

---

Back to resources index - Back to main README.md