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
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.