From ec96eacd0e6f297a64ee058b22ce9f567c0860e3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Julien=20D=C3=A9ramond?= Date: Fri, 22 Nov 2024 10:54:10 +0100 Subject: [PATCH] Docs: add warning callout for Yarn Berry for Bootstrap examples compat (#41036) --- site/content/docs/5.3/getting-started/download.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/site/content/docs/5.3/getting-started/download.md b/site/content/docs/5.3/getting-started/download.md index 2d0d62762772..e15cb9860c84 100644 --- a/site/content/docs/5.3/getting-started/download.md +++ b/site/content/docs/5.3/getting-started/download.md @@ -100,6 +100,17 @@ Install Bootstrap in your Node.js powered apps with [the yarn package](https://y yarn add bootstrap@{{< param "current_version" >}} ``` +{{< callout warning >}} +**Yarn 2+ (aka Yarn Berry) doesn't support the `node_modules` directory by default**: using our [Sass & JS example](https://github.com/twbs/examples/tree/main/sass-js) needs some adjustments: + +```sh +yarn config set nodeLinker node-modules # Use the node_modules linker +touch yarn.lock # Create an empty yarn.lock file +yarn install # Install the dependencies +yarn start # Start the project +``` +{{< /callout >}} + ### RubyGems Install Bootstrap in your Ruby apps using [Bundler](https://bundler.io/) (**recommended**) and [RubyGems](https://rubygems.org/) by adding the following line to your [`Gemfile`](https://bundler.io/guides/gemfile.html):