Migrate to yarn for installing dependencies

.github/workflows/simorgh-deploy-storybook.yml

@@ -25,11 +25,11 @@ jobs:
 
       - name: Install Node Modules
         if: steps.cache.outputs.cache-hit != 'true'
-        run: npm ci
+        run: yarn install --frozen-lockfile
 
       - name: Build Storybook
         run: |
-          npm run build:storybook
+          yarn run build:storybook
           git config --global user.name "simorgh-bbc"
           git config --global user.email "DENewsSimorghDev@bbc.co.uk"
 

.github/workflows/simorgh-integration-tests.yml

@@ -36,7 +36,7 @@ jobs:
 
       - name: Install Node Modules
         if: steps.cache.outputs.cache-hit != 'true'
-        run: npm ci
+        run: yarn install --frozen-lockfile
 
       - name: Integration Tests
-        run: npm run test:integration -- --ci
+        run: yarn run test:integration -- --ci

.github/workflows/simorgh-local-server-tests.yml

@@ -35,24 +35,25 @@ jobs:
 
       - name: Install Node Modules
         if: steps.cache.outputs.cache-hit != 'true'
-        run: npm ci
+        run: yarn install --frozen-lockfile
 
       - name: Build Simorgh
-        run: npm run build:local
+        run: yarn run build:local
 
       - name: Start Simorgh Server
         run: nohup node build/server.js > /dev/null 2>&1 &
 
       - name: Run AMP Validator
-        run: npm run amp:validate
+        run: yarn run amp:validate
 
       - name: Run bbc-a11y
-        run: npm run bbcA11y:ci
+        run: yarn run bbcA11y:ci
 
       - name: Run Lighthouse
-        run: npm run lighthouse
+        run: yarn run lighthouse
 
       - name: Run Puppeteer Tests
         run: |
-          npm install --no-save puppeteer
-          npm run test:puppeteer
+          yarn add puppeteer
+          yarn run test:puppeteer
+          yarn remove puppeteer

.github/workflows/simorgh-misc-checks.yml

@@ -37,7 +37,7 @@ jobs:
 
       - name: Install Node Modules
         if: steps.cache.outputs.cache-hit != 'true'
-        run: npm ci
+        run: yarn install --frozen-lockfile
 
       - name: Chromatic UI Tests
         uses: chromaui/action@v1

.github/workflows/simorgh-unit-tests.yml

@@ -47,12 +47,12 @@ jobs:
 
       - name: Install Node Modules
         if: steps.cache.outputs.cache-hit != 'true'
-        run: npm ci
+        run: yarn install --frozen-lockfile
 
       - name: Build Simorgh
         run: |
           echo ${GITHUB_REF##*/}
-          npm run build
+          yarn run build
 
       - name: Setup Code Climate Test Coverage
         if: ${{ github.event_name == 'push' || github.event.pull_request.head.repo.full_name == 'bbc/simorgh' }} # Only run if PR originates from the Simorgh repo
@@ -64,7 +64,7 @@ jobs:
           ./cc-test-reporter before-build
 
       - name: Unit Tests
-        run: npm run test:unit
+        run: yarn run test:unit
 
       - name: Report Code Climate Test Coverage
         if: ${{ github.event_name == 'push' || github.event.pull_request.head.repo.full_name == 'bbc/simorgh' }} # Only run if PR originates from the Simorgh repo

.yarnrc

@@ -0,0 +1 @@
+version=1.22.10

CONTRIBUTING.md

@@ -36,19 +36,44 @@ If you never created a pull request before, [here is a great tutorial on how to
 
 Fork the project, clone your fork, configure the remotes and install the dependencies:
 
+1. Clone your fork of the repo into the current directory
+
+   ```
+   git clone https://github.com/<YOUR ACCOUNT>/simorgh.git
+   ```
+
+2. Navigate to the newly cloned directory
+
+   ```
+   cd simorgh
+   ```
+
+3. Assign the original repo to a remote called "upstream"
+
+   ```
+   git remote add upstream https://github.com/bbc/simorgh
+   ```
+
+4. Use recommended version of node for the project, listed in [`.nvmrc`](https://github.com/bbc/simorgh/blob/latest/.nvmrc)
+
+   ```
+   nvm use
+   ```
+
+### Installing dependencies
+
+**Install Yarn**
+
+The Simorgh project uses Yarn for package management. To install Yarn, run this command:
+
+```
+npm install --global yarn
+```
+
+**Install the project dependencies with Yarn**
+
 ```
-# Clone your fork of the repo into the current directory
-git clone https://github.com/<YOUR ACCOUNT>/simorgh.git
-# Navigate to the newly cloned directory
-cd simorgh
-# Assign the original repo to a remote called "upstream"
-git remote add upstream https://github.com/bbc/simorgh
-# Use recommended version of node for the project, listed in `.nvmrc`
-nvm use
-# Install latest version of npm
-npm install --global npm@latest
-# Install the project dependencies
-npm install
+yarn install
 ```
 
 If it has been a while since you've cloned the repo, pull from the `latest` branch
@@ -183,7 +208,7 @@ If on the other hand you are adding new files to the root directory of simorgh,
 
 ### `.env` is showing in my `git status`
 
-The `.env` file should not be commited as it is often overwritten by the values in `envConfig/` at build time. There is a `postshrinkwrap` command which runs after an `npm install` so should be run during setup of the application.
+The `.env` file should not be commited as it is often overwritten by the values in `envConfig/` at build time. There is a `postshrinkwrap` command which runs after an `yarn install` so should be run during setup of the application.
 
 If the `.env` file is appearing in your `git status` it means it is now longer being assumed as unchanged, to fix this run:
 

README.md

@@ -158,12 +158,20 @@ Install Node. [https://nodejs.org/en/](https://nodejs.org/en/). We use the versi
 nvm use
 ```
 
+#### Install Yarn
+
+The Simorgh project uses Yarn for package management. It is recommended to install Yarn through the npm package manager, which comes bundled with Node.js when you install it on your system. To install Yarn, run this command:
+
+```
+npm install --global yarn
+```
+
 Then you can run the following commands to install Simorgh
 
 ```
 git clone git@github.com:bbc/simorgh.git
 cd simorgh
-npm install
+yarn install
 ```
 
 ## Local Development

codebuild/e2e_buildspec.yml

@@ -10,11 +10,11 @@ phases:
       nodejs: 12
   pre_build:
     commands:
-      - npm ci
-      - npm run build
+      - yarn install --frozen-lockfile
+      - yarn run build
   build:
     commands:
-      - npm run cypress:ci
+      - yarn run cypress:ci
 reports:
   JunitReportsTest:
     files: