build: bump yarn to 3.8.7

[aresnik11]

Overview

Bumps yarn to 3.8.7 to match mono. Note: probably won't merge this and instead will branch off of it to bump to yarn 4

PR Checklist

• Related to designs:
• Related to JIRA ticket: GMT-1464
• I have run this code to verify it works
• This PR includes unit tests for the code change
• This PR includes testing instructions tests for the code change
• The alpha package of this PR is passing end-to-end tests in all relevant Codecademy repositories

Testing Instructions

1. Go to storybook preview
2. Confirm everything works as expected
3. Pull the branch locally
4. Go to storybook
5. Confirm everything works as expected
6. Confirm the alpha works in mono/lith
7. Finish and do a celebratory dance

PR Links and Envs

Repository	PR Link
Monolith	Monolith PR
Mono	Mono PR

[nx-cloud]

View your CI Pipeline Execution ↗ for commit 3254e04

---

☁️ Nx Cloud last updated this comment at 2026-01-09 19:01:44 UTC

[dreamwasp]

looks great and matches all the yarn migration docs! only not approving since you're branching off of this for yarn 4.

[jakemhiller]

fwiw corepack shouldn't technically be necessary b/c you have the yarn binary in .yarn/releases , and nodeLinker is set in the .yarnrc. we've used this pattern in dockerfiles before because they don't have access to those files, but in CI they should be there.

[aresnik11]

just so i understand, you're saying i can just have this as yarn install --immutable?

[jakemhiller]

yeah that's what i meant. That said, after i wrote this in Bana's PR we went the other way and removed the binary from the repo and relied entirely on corepack.

So maybe we keep this, but you should be able to simplify it to:

corepack enable && yarn install --immutable

since nodeLinker is already set in the .yarnrc.yml file

[aresnik11]

do we want to do the same in this repo? i can do it in the yarn 4 branch if so

[codecademydev]

📬 Published Alpha Packages:

eslint-plugin-gamut@2.4.1-alpha.247c6e.0
@codecademy/gamut@67.6.3-alpha.247c6e.0
@codecademy/gamut-icons@9.54.1-alpha.247c6e.0
@codecademy/gamut-illustrations@0.57.1-alpha.247c6e.0
@codecademy/gamut-kit@0.6.576-alpha.247c6e.0
@codecademy/gamut-patterns@0.10.20-alpha.247c6e.0
@codecademy/gamut-styles@17.11.1-alpha.247c6e.0
@codecademy/gamut-tests@5.2.18-alpha.247c6e.0
@codecademy/variance@0.25.1-alpha.247c6e.0

[github-actions]

🚀 Styleguide deploy preview ready!

Preview URL: https://6961511bd38f0755987a4e03--gamut-preview.netlify.app
Deploy Logs: https://app.netlify.com/projects/gamut-preview/deploys/6961511bd38f0755987a4e03

[aresnik11]

changes were included here #3233