Yarn Setup for Heatwave Master

This project requires specific versions of Node.js and Yarn to work properly.

Node.js Version

  • Required: Node.js v16.18.1
  • Current: Set via .nvmrc file

Yarn Version

  • Required: Yarn 3.1.1 (Berry)
  • Location: .yarn/releases/yarn-3.1.1.cjs

Usage

Option 1: Use the project-specific wrapper script

./yarn.sh install
./yarn.sh build
./yarn.sh [any-other-command]

Option 2: Use the full path to yarn

.yarn/releases/yarn-3.1.1.cjs install
.yarn/releases/yarn-3.1.1.cjs build
.yarn/releases/yarn-3.1.1.cjs [any-other-command]

Option 3: Switch to the correct Node.js version first

nvm use 16.18.1
# Then you can use yarn normally (if you have it installed globally)
yarn install
yarn build

Important Notes

  • This project is pinned to Node.js v16.18.1 for compatibility
  • The project uses Yarn 3 (Berry) with the node-modules linker
  • Do not modify global shell configurations - use project-specific solutions
  • Each project folder may have different Node.js/Yarn version requirements

Troubleshooting

If you get "Couldn't find the node_modules state file" errors:

  1. Ensure you're using Node.js v16.18.1 (nvm use 16.18.1)
  2. Clear yarn cache: .yarn/releases/yarn-3.1.1.cjs cache clean
  3. Remove node_modules and reinstall: rm -rf node_modules && ./yarn.sh install