Intro & Project Setup

A monorepo is the concept of many software packages being stored in the same SCM repository. There are several key benfits

In this course, we’ll refactor a small client/server app into monorepo. By the end, we’ll have

Monorepo dependencies automatically linked
Parallized dependency-aware task execution for build, linting and testing
Commands for CI that run tests on only the code affected by the change
Support for some packages in the monorepo being more coupled with each other than others, by design (e.g. using private functionality)
Automatic code documentation

We’re going to be using some of the latest and greatest tooling, including

pnpm
lerna v7
nx for distributed caching
api-extractor for .d.ts rollups
api-documenter for auto-generated docs
GitHub CODEOWNERS to control who should review which parts of the monorepo?
changesets for unified changelogs
manypkg for detecting common pitfalls in package.jsons across your monorepo
syncpack (or an equivalent nx tool) to rally your monorepo around a single version of each dependency
…and more!!!

Project setup

If you don’t using volta (get it at https://volta.sh) is a great way to obtain it.

First, install volta

sh
curl https://get.volta.sh | bash

You may need to close and reopen your terminal before your can verify that your environment has volta installed

sh
volta --version
> 2.0.2

Then you can run

sh
volta install pnpm

And you should be good to go. Alternatively you can follow pnpm’s direct installation instructions

sh
git clone git@github.com:mike-north/ts-monorepos-v2

sh
cd ts-monorepos-v2  # Enter the project folder
pnpm install        # Install dependencies

sh
pnpm run build      # Build the project
pnpm run lint       # Lint the project
pnpm run test       # Test the project

sh
pnpm run dev

You should be able to go to http://localhost:3000/api/seeds in a browser and see some JSON
You should be able to go to http://localhost:5173/ and see a UI that looks like this