Ever thought about joining us? https://workforus.theguardian.com/careers/product-engineering/

This repository contains the rendering logic for articles on theguardian.com. It is a monorepo with 2 projects, apps-rendering and dotcom-rendering.

Install Node.js.

We recommend using fnm. It is great at managing multiple versions of Node.js on one machine.

Install Yarn 1 (Classic).

Run yarn in the root directory of this project to install packages.

You should always cd into the correct subdirectory before running commands (e.g make dev for dotcom-rendering, or yarn watch for apps-rendering) except for storybook.

Go to apps rendering for more details.

Go to dotcom rendering for more details.

Most commands are run from within each project but the following are managed from the monorepo root:

yarn storybook - Runs Storybook for all projects yarn build-storybook - Builds Storybook for all projects

Chromatic now runs at project level. cd into the project dir and run yarn chromatic -t [CHROMATIC PROJECT TOKEN]

You can find the token in the project Chromatic instance.

To run Chromatic in CI on your pr, add the run_chromatic label once you're ready to check for visual regressions.