Skip to main content
Version: Canary

Using Yarn

What is Yarn?

Yarn is a package manager for JavaScript. It is used to manage and install dependencies for JavaScript projects, particularly for Node.js applications. Yarn offers features like parallel package installations and offline caching and uses a yarn.lock file to control and reproduce consistent installations of dependencies across different environments.

Installing yarn

"The preferred way to manage Yarn is through Corepack, a new binary shipped with all Node.js releases starting from 16.10."
-from the Yarn documentation

Corepack is included with all Node.js >=16.10 installs, but you must opt-in. To enable it, run the following command:

corepack enable

Using the correct version of yarn

To see the version of yarn that you have installed, run the following command:

yarn --version

Redwood requires Yarn (>=1.22.21)

You can upgrade yarn by running the following command:

corepack prepare yarn@stable --activate
info

If this command fails, you may need to uninstall the current version of Yarn first.

corepack disable
npm uninstall -g yarn --force
corepack enable

Installing packages and dependencies with yarn

You'll need to run yarn install in the root of your project directory to install all the necessary packages and dependencies for your project.

Redwood separates the backend (api) and frontend (web) concerns into their own paths in the codebase. (Yarn refers to these as "workspaces". In Redwood, we refer to them as "sides.") When you add packages going forward you'll need to specify which workspace they should go in.

For example to install a package on the web or frontend side, you would run the following command:

yarn workspace web add package-name

and to install a package on the api or backend side, you would run the following command:

yarn workspace api add package-name

Uninstalling yarn

To uninstall yarn, run the following command:

corepack disable
npm uninstall -g yarn --force

Additional Information

For additional information, you can refer directly to the yarn documentation.