Introduction

Challenges in managing a large number of repositories

Overcoming Challenges with Multiple Repositories - A Deep Dive into Package Management and Workspaces

We will discuss what monorepos are and the essential criteria for monorepo implementation

What are monorepos?

An introduction to PNPM and its benefits.

Understanding and Utilizing PNPM - An efficient package manager for Node.js

We are going to set up a monorepo folder structure with PNPM workspaces.

Setting Up a Monorepo Folder Structure with PNPM Workspaces

Create our first application inside the PNPM workspace.

Creating Your First React App in a PNPM Worskpace

Getting Started

We are going create a shared library using React and TypeScript.

Building and Using Shared Repositories in React with PNPM

We are going import a ccomponent from a shared library into our main app.

Utilizing a Shared UI Library in a React Application with TypeScript and PNPM

Shared Repositories

An intro to Nx and the features it provides the developers

Harnessing the Power of Nx in Software Development

How to add Nx to the workspace and running Nx commands

Getting Started with NX in your Workspace: An Installation Guide

Mastering Project Management with Nx: Using Nx commands

An intro to Nx graph to identify dependencies

Understanding Dependency Graphs with Nx

An Insight into NX Caching: Improving Build Times and Developer Productivity

Configure caching strategies based on your project's requirements

Leveraging Nx Caching in Software Development

Caching

Make sure dependencies are built first before running an application using dependsOn field.

Managing Dependencies and Optimizing Workspaces with NX's Task Pipeline

Use advanced optimizations beyond caching for growing applications and packages within your monorepo.

Optimizing Nx Workspaces with the 'Affected' Command

Nx Task Pipeline Features and Workspace Optimization

Gain a solid understanding of what Nx plugins are, how they work, and why they are a crucial component of the Nx ecosystem.

Maximize Efficiency with NX Plugins: A Comprehensive Guide

How to use the generators to scaffold new projects

Creating Custom Generators for Project Scaffolding with Nx

Creating custom plugins and scaffolding new packages with generators

Conclusion

We have created a course on how to build monorepos using Nx which is a powerful build system that provides tools and techniques for enhancing developer productivity, optimizing CI performance, and maintaining code quality. 
Monorepos are an excellent way to reduce the complexity of mutiple codebases, reuse code and increase productivity, but most software engineers working on enterprise solutions find it confusing where to even start.

In this course we cover how to install and configure Nx to speed up development by reducing complexity by improving code organization via code sharing between different projects, ways to optimize builds with local and remote cache, increase test coverage locally and how to configure CI alogn with the tooling via its plugins.

It's taught by Sean Amarasinghe who is a Lead Engineer who has been working with Nx and PNPM integrating it into multiple monorepos.

Predictably Collaborate on and Automate Complex Apps at Scale

In this course we learn how to structure a monorepo with PNPM workspaces, install Nx and use its tooling to optimise CI performance and maintain code quality

The Art of Enterprise Monorepos with Nx and pnpm

How to structure a monorepo with PNPM workspaces, install Nx and use its tooling to optimize CI performance and maintain code quality.

Importance of managing multiple projects, libraries, and applications within a single, centralized repository to enhance productivity and code maintainability. 

By utilizing Nx, a powerful and extensible toolkit, you will learn to streamline the development workflow within monorepos.

In the previous lesson, we explored the world of PNPM and its contributions to project management. In this lesson, we will go a step further by setting up a monorepo folder structure with PNPM workspaces. This guide will outline the process of creating a PNPM workspace that hosts multiple packages, aiding in efficient and streamlined project management.

To start you can create an empty folder. Let's name it 

Fire up your Visual Studio instance and open the newly created folder. In order to
create a PNPM workspace you can create a file named 

 - this is the first step towards creating your PNPM workspace.

---
title: Setting Up a Monorepo Folder Structure with PNPM Workspaces
description: We are going to set up a monorepo folder structure with PNPM workspaces.
privateVideoUrl: https://stream.mux.com/r02qRoHBwed01WfnkdqtoNtmEGv01v35GDNluLpIp9gyqg.m3u8
isPublicLesson: true
code: https://gitlab.com/fullstackio/books/newline-course-apps/sean-amarasinghe-monorepos-for-enterprise-developers-app/-/tree/main/Course%20App/module_2
---

# Setting Up a Monorepo Folder Structure with PNPM Workspaces

## Introduction

In the previous lesson, we explored the world of PNPM and its contributions to project management. In this lesson, we will go a step further by setting up a monorepo folder structure with PNPM workspaces. This guide will outline the process of creating a PNPM workspace that hosts multiple packages, aiding in efficient and streamlined project management.

# Setting Up Your PNPM Workspace

## Steps

To start you can create an empty folder. Let's name it `monorepo-with-nx` or you can give it a different name.  

```bash
mkdir monorepo-with-nx
```

Fire up your Visual Studio instance and open the newly created folder. In order to
create a PNPM workspace you can create a file named `pnpm-workspace.yaml` - this is the first step towards creating your PNPM workspace.

```bash
touch pnpm-workspace.yaml
```

Sean Amarasinghe

Welcome to the second module. I hope you're excited about getting started with

building mono repos. In the last module we discussed about the challenges

to manage a large number of repositories. This also means we will have to deal

with way too many node modules installed in those individual repositories. In

lesson we are going to discuss about a package manager that could solve this

issue. pnpm short for plug-and-play package manager is an alternative

package manager for node js applications similar to npm short for

node package manager and also yarn. Here are some reasons why you might choose

use pnpm. pnpm uses unique approach called content

admissible storage to store packages. Instead of duplicating packages in each

project it stores them in a global store and creates hard links to the

packages in each project. This results in significant disk space savings

to the other package managers. Fast installation is another benefit that we

get from pnpm. Since pnpm uses global store and hard links installing

packages is often faster compared to npm and yarn especially when multiple

projects share the same dependencies. pnpm uses a partial flat node module

structure. In order to manage dependencies pnpm uses the symbolic link and hard

link pattern. This means that there are no nested node modules

to create for each package which can help with file system performance and

reduce the likelihood of hitting file path link limits on certain operating

systems. pnpm supports concurrent installations by default. This means that

it can download and install multiple packages speeding up the installation

speed. pnpm generates a pnpm lock yaml file which is similar to package -lock

JSON file with npm or yarn lock file with yarn. pnpm lock file helps to lock

down the dependency versions. This ensures that the same versions of

dependencies are installed across different environments. pnpm has built

in support for an offline mode. Once packages are installed they can be cached

locally allowing you to install dependencies even without an internet

connection. pnpm is designed to work well with monoripose where multiple

packages or projects are managed together. It provides efficient linking

and sharing of dependencies across projects within monoripo. In this lesson

we learned what pnpm is and why we chose it as our go-to package manager.

In the next lesson we will learn how to set up a pnpm workspace