Now 100x Faster

Read the latest from Gatsby CTO Kyle Mathews Re-introducing Gatsby, a Reactive Site Generator

Monorepos

Introduction

Gatsby Cloud has support for projects organized as monorepos, but since there are different competing tools to build a monorepo it’s important to know what Gatsby Cloud supports today.

This document will explain which tools are supported and how you can troubleshoot issues.

Supported tools

The following table shows the level of support for each tool.

Legend:

IconFeature Capability
Fully Supported
Somewhat Supported (support is minimal )
Not Supported

Support:

Tool.Level of SupportNotes
Yarn Workspaces (v1)
Yarn Workspaces (v2/v3 with PnP)
Lerna
NPM Workspaces (v7 and onwards)
NXFull support for detecting and installing dependencies
TurborepoWe do not have plans to support Turborepo at this time.

Troubleshooting

PnP and Yarn compatibility issues

Some tools don’t work under Plug’n’Play environments, check the Yarn compatibility table. You can enable the built-in node-modules plugin by adding the following into your local .yarnrc.yml file before running a fresh yarn install:

Edit this page on GitHub
© 2022 Gatsby, Inc.