Add Workspace

Workspaces are folders that contain packages or applications. In a monorepo, workspaces are used to group related packages and applications together. In this guide, you will learn how to add new workspaces to your monorepo.

Command

This command allows you to add new workspaces to the monorepo.

Global

monopkg workspace add [workspaces...] [options]

Bun

bun x monopkg workspace add [workspaces...] [options]

NPM

npx monopkg workspace add [workspaces...] [options]

Yarn

yarn dlx monopkg workspace add [workspaces...] [options]

FYI

In the interactive mode, you can enter multiple workspace name to be added. The prompt will keep asking for the workspace name until you press Enter without entering a name.

Options

• --cold - Cold run, skip creating the workspace folder.

Examples

Single Workspace

Add a new workspace named tools:

Global

monopkg workspace add tools

Bun

bun x monopkg workspace add tools

NPM

npx monopkg workspace add tools

Yarn

yarn dlx monopkg workspace add tools

Output

Folder Structure

├─ packages
|  ├─ pkg-a
|  ├─ pkg-b
├─ tools 
|  └─ .gitkeep 
└─ package.json

package.json

{
  "workspaces": [
    "packages/*",
    "tools/*"
  ]
}

Multiple Workspaces

Add multiple workspaces named tools and apps:

Global

monopkg workspace add tools apps

Bun

bun x monopkg workspace add tools apps

NPM

npx monopkg workspace add tools apps

Yarn

yarn dlx monopkg workspace add tools apps

Output

Folder Structure

├─ apps 
|  └─ .gitkeep 
├─ packages
|  ├─ pkg-a
|  ├─ pkg-b
├─ tools 
|  └─ .gitkeep 
└─ package.json

package.json

{
  "workspaces": [
    "apps/*", 
    "packages/*",
    "tools/*"
  ]
}

---

Skip Creating Workspace Folder

Add a new workspace named tools and skip creating the workspace folder:

Global

monopkg workspace add tools --cold

Bun

bun x monopkg workspace add tools --cold

NPM

npx monopkg workspace add tools --cold

Yarn

yarn dlx monopkg workspace add tools --cold

Output

Folder Structure

├─ packages
|  ├─ pkg-a
|  ├─ pkg-b
└─ package.json

package.json

{
  "workspaces": [
    "packages/*",
    "tools/*"
  ]
}