by react-workspaces

react-workspaces /react-workspaces-playground

βš›οΈ 🐈 Zero Config Create-React-App Monorepos with Yarn Workspaces, Lerna and React Storybook.

561 Stars 103 Forks Last release: Not found 74 Commits 0 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

React Workspaces Playground Screenshots

Join us on Slack

πŸ’₯ Now supports TypeScript and React-App-Rewired!


  • βš›οΈ Create React App 3 (React 16.8)
  • πŸ“– Storybook 5
  • 🐈 Yarn Workspaces
  • πŸ‰ Lerna 3
  • ✨ Host Multiple CRA Apps, Component Libraries & Storybooks in one Monorepo
  • πŸ”₯ Hot Reload all Apps, Components & Storybooks
  • πŸ‘¨β€πŸ”¬ Test all workspaces with Eslint & Jest using one command
  • :octocat: Deploy your apps to Github Pages using one command




  • Yarn 1.13.0
  • Node 11.14.0


git clone [email protected]:react-workspaces/react-workspaces-playground.git
cd react-workspaces-playground

Adding workspace dependencies

yarn workspace  

This will run the chosen Yarn command in the selected workspace.


yarn workspace my-app add react-router-dom --dev

This will add

in your
. To remove dependency use
instead of add


Starting Project in Workspace

From your project root type start command for desired app

yarn workspace @project/app-single-comp start

All available

"scripts": {
    "start:app-ant-design": "yarn workspace @project/app-ant-design-rewired start",
    "start:app-multi": "yarn workspace @project/app-multi-comps start",
    "start:app-single": "yarn workspace @project/app-single-comp start",
    "start:app-ts": "yarn workspace @project/app-typescript start",
    "start:storybook": "yarn workspace @project/storybook storybook",
    "start:storybook-ts": "yarn workspace @project/storybook-typescript storybook",

Starting The Storybook

yarn start:storybook

Linting & Testing

yarn workspace  test

Deploying to GitHub Pages

Update the

URL in
to reflect your GitHub Pages URL.
  "name": "@project/app-single-comp",
  "private": true,
  "homepage": "",
  "scripts": {
    "deploy": "gh-pages -d build"

Run the deploy script.

yarn workspace  deploy

Creating a New CRA App

Use Create React App's

flag to create a new React App with Yarn Workspaces support.
create-react-app --scripts-version @react-workspaces/react-scripts my-app

To create new TS app use Create React App's

flag with
flag to create a new React App with Yarn Workspaces support and Typescript.
npx create-react-app --scripts-version @react-workspaces/react-scripts --template typescript my-ts-app

How Does It Work?

React Workspaces Playground uses a custom version of

under the hood. The custom
is an NPM package to use in place of the
dependency that usually ships with Create React App. See: (@react-workspaces/react-scripts) on NPM.

Support for Yarn Workspaces was added by:

  1. Adding yarn-workspaces.js file to resolve workspaces modules.

  2. Updating the Webpack config:

  • Use

    for loading development source code.
  • Use

    settings based on your
    yarn workspaces
    settings in your
       "workspaces": {
         "packages": ["packages/apps/*", "packages/components", "packages/storybook"],
         "production": true,
         "development": true,
         "package-entry": "main:src"

Minimal updates to the Webpack config were required.


--- a/./facebook/react-scripts/config/webpack.config.js
+++ b/react-workspaces/react-scripts/config/webpack.config.js
@@ -9,7 +9,6 @@
'use strict';

const fs = require('fs'); const isWsl = require('is-wsl'); const path = require('path'); const webpack = require('webpack'); const resolve = require('resolve'); @@ -28,15 +27,14 @@ const WatchMissingNodeModulesPlugin = require('react-dev-utils/WatchMissingNodeM const ModuleScopePlugin = require('react-dev-utils/ModuleScopePlugin'); const getCSSModuleLocalIdent = require('react-dev-utils/getCSSModuleLocalIdent'); const paths = require('./paths'); const modules = require('./modules'); +const workspaces = require('./workspaces'); const getClientEnvironment = require('./env'); const ModuleNotFoundPlugin = require('react-dev-utils/ModuleNotFoundPlugin'); const ForkTsCheckerWebpackPlugin = require('react-dev-utils/ForkTsCheckerWebpackPlugin'); const typescriptFormatter = require('react-dev-utils/typescriptFormatter'); // @remove-on-eject-begin const getCacheIdentifier = require('react-dev-utils/getCacheIdentifier'); // @remove-on-eject-end

// Source maps are resource heavy and can cause out of memory issue for large source files. const shouldUseSourceMap = process.env.GENERATE_SOURCEMAP !== 'false'; @@ -53,12 +51,22 @@ const cssModuleRegex = /.module.css$/; const sassRegex = /.(scss|sass)$/; const sassModuleRegex = /.module.(scss|sass)$/;

+const workspacesConfig = workspaces.init(paths); + // This is the production and development configuration. // It is focused on developer experience, fast rebuilds, and a minimal bundle. module.exports = function(webpackEnv) { const isEnvDevelopment = webpackEnv === 'development'; const isEnvProduction = webpackEnv === 'production';

  • const workspacesMainFields = [workspacesConfig.packageEntry, 'main'];
  • const mainFields =
  • isEnvDevelopment && workspacesConfig.development
  • ? workspacesMainFields
  • : isEnvProduction && workspacesConfig.production
  • ? workspacesMainFields
  • : undefined;
  • // Webpack uses publicPath to determine where the app is being served from. // It requires a trailing slash, or the file assets will get an incorrect path. // In development, we always serve from the root. This makes config easier. @@ -279,6 +282,7 @@ module.exports = function(webpackEnv) {
     extensions: paths.moduleFileExtensions
       .map(ext => `.${ext}`)
       .filter(ext => useTypeScript || !ext.includes('ts')),
  • mainFields, alias: { // Support React Native Web // @@ -330,7 +335,11 @@ module.exports = function(webpackEnv) {
       loader: require.resolve('eslint-loader'),
  • include: paths.appSrc,
  • include: isEnvDevelopment && workspacesConfig.development
  • ? [paths.appSrc, workspacesConfig.paths]
  • : isEnvProduction && workspacesConfig.production
  • ? [paths.appSrc, workspacesConfig.paths]
  • : paths.appSrc, }, { // "oneOf" will traverse all following loaders until one will @@ -352,7 +361,12 @@ module.exports = function(webpackEnv) { // The preset includes JSX, Flow, TypeScript, and some ESnext features. { test: /.(js|mjs|jsx|ts|tsx)$/,
  • include: paths.appSrc,
  • include:
  • isEnvDevelopment && workspacesConfig.development
  • ? [paths.appSrc, workspacesConfig.paths]
  • : isEnvProduction && workspacesConfig.production
  • ? [paths.appSrc, workspacesConfig.paths]
  • : paths.appSrc, loader: require.resolve('babel-loader'), options: { customize: require.resolve(

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.