pnpm & monorepos

curl -fsSL https://get.pnpm.io/install.sh | sh -
npx get-pnpm                  # via npm (Node 22.13+)
pnpm self-update              # latest; or self-update 12.7.0
pnpm --version
 
corepack enable pnpm          # Node 24 only: Corepack
                              # isn't bundled from Node 25

packages:
  - apps/*
  - packages/*
  - "!**/test/**"
 
catalog:                  # "react": "catalog:"
  react: ^19.2.0
  zod: ^4.5.0
catalogs:
  react18:                # "react": "catalog:react18"
    react: ^18.3.1
 
allowBuilds:              # deps allowed to run scripts
  esbuild: true
  sharp: true
  core-js: false          # silence, never build
 
minimumReleaseAge: 1440   # minutes: skip versions < 1 day
minimumReleaseAgeExclude:
  - "@acme/*"
 
overrides:
  "lodash@<4.17.21": ^4.17.21
  "express>qs": 6.13.0
  "foo@1>bar": "-"        # remove a transitive dep
 
packageExtensions:
  some-pkg@1:
    peerDependencies:
      react: "*"
 
patchedDependencies:
  left-pad@1.3.0: patches/left-pad@1.3.0.patch
 
publicHoistPattern:
  - "*eslint*"
  - "*prettier*"

@acme:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}
//registry.npmjs.org/:_authToken=${NPM_TOKEN}

{
  "name": "@acme/api",
  "private": true,
  "type": "module",
  "dependencies": {
    "@acme/db": "workspace:*",
    "@acme/utils": "workspace:^",
    "zod": "catalog:"
  },
  "devDependencies": {
    "@acme/tsconfig": "workspace:*"
  }
}

{
  "name": "@acme/tsconfig",
  "private": true,
  "files": ["*.json"],
  "exports": {
    "./base.json": "./base.json",
    "./node.json": "./node.json",
    "./react.json": "./react.json"
  }
}

{
  "compilerOptions": {
    "target": "es2024",
    "lib": ["es2024"],
    "module": "nodenext",
    "moduleResolution": "nodenext",
    "strict": true,
    "noUncheckedIndexedAccess": true,
    "verbatimModuleSyntax": true,
    "erasableSyntaxOnly": true,
    "isolatedModules": true,
    "skipLibCheck": true,
    "types": []
  }
}

{
  "extends": "@acme/tsconfig/base.json",
  "compilerOptions": {
    "composite": true,
    "rootDir": "src",
    "outDir": "dist",
    "types": ["node"]
  },
  "include": ["src"],
  "references": [{ "path": "../db" }]
}

{
  "files": [],
  "references": [
    { "path": "apps/api" },
    { "path": "packages/utils" },
    { "path": "packages/db" }
  ]
}

tasks:
  build:
    dependsOn: ["^build"]     # deps' build first
    outputs: ["dist/**"]      # cacheable (pnpm pipeline)
  test:
    dependsOn: ["build"]      # own build first
pipelines:
  default: [build, test, lint]

pnpm -r run build           # follows tasks.dependsOn
pnpm pipeline               # frozen install, affected since
                            # origin/main, cached results
pnpm pipeline --base main --dry-run

{
  "$schema": "https://turborepo.dev/schema.json",
  "ui": "tui",
  "tasks": {
    "build": {
      "dependsOn": ["^build"],
      "inputs": ["$TURBO_DEFAULT$", ".env*"],
      "outputs": ["dist/**", ".next/**", "!.next/cache/**"]
    },
    "typecheck": { "dependsOn": ["^build"] },
    "test": { "dependsOn": ["build"], "outputs": [] },
    "lint": {},
    "dev": { "cache": false, "persistent": true }
  }
}

pnpm change --bump minor --summary "Add Button size" \
  @acme/ui                    # non-interactive intent
pnpm change status            # pending intents
pnpm version -r               # apply bumps + CHANGELOG.md
pnpm -r publish --access public   # skips existing versions
pnpm publish --dry-run --filter @acme/ui

pnpm patch left-pad@1.3.0     # prints a temp dir to edit
# ...edit files in that dir...
pnpm patch-commit /tmp/abc123  # writes patches/*.patch +
                               # patchedDependencies entry
pnpm patch-remove left-pad@1.3.0

mkdir acme && cd acme && git init
pnpm init                        # pins pnpm in package.json
pnpm pkg set private=true
mkdir -p apps packages tooling
cat > pnpm-workspace.yaml <<'EOF'
packages:
  - apps/*
  - packages/*
  - tooling/*
EOF
pnpm add -w -D typescript turbo --save-catalog
# root devDependencies now say "catalog:"
pnpm pkg set scripts.build="turbo run build" \
  scripts.test="turbo run test"
printf "node_modules\ndist\n.turbo\n" > .gitignore
pnpm install

mkdir -p packages/utils/src
cat > packages/utils/package.json <<'EOF'
{
  "name": "@acme/utils",
  "private": true,
  "type": "module",
  "exports": { ".": "./src/index.ts" }
}
EOF
cat > packages/utils/src/index.ts <<'EOF'
export const slug = (s: string) =>
  s.toLowerCase().replace(/\W+/g, "-");
EOF
pnpm --filter @acme/api add "@acme/utils@workspace:*"
pnpm --filter @acme/api exec tsc --noEmit

mkdir -p tooling/tsconfig
cat > tooling/tsconfig/package.json <<'EOF'
{ "name": "@acme/tsconfig", "private": true,
  "files": ["*.json"] }
EOF
# add base.json, node.json, react.json (see above)
pnpm --filter "./apps/*" --filter "./packages/*" \
  add -D "@acme/tsconfig@workspace:*"

{
  "extends": "./base.json",
  "compilerOptions": {
    "lib": ["es2024", "dom", "dom.iterable"],
    "jsx": "react-jsx",
    "module": "esnext",
    "moduleResolution": "bundler",
    "noEmit": true
  }
}

git fetch origin main --depth=50
# pnpm filters
pnpm --filter "...[origin/main]" -r run lint
pnpm --filter "...[origin/main]" -r run test
# pnpm 12 pipeline (affected + cache)
pnpm pipeline --base origin/main
# Turborepo
pnpm turbo run build test --affected
# Nx
pnpm nx affected -t build test --base=origin/main

FROM ghcr.io/pnpm/pnpm:12 AS build
RUN pnpm runtime set node 24 -g
WORKDIR /repo
COPY pnpm-lock.yaml pnpm-workspace.yaml ./
RUN --mount=type=cache,id=pnpm,target=/pnpm/store \
    pnpm fetch
COPY . .
RUN --mount=type=cache,id=pnpm,target=/pnpm/store \
    pnpm install --offline --frozen-lockfile
RUN pnpm --filter "@acme/api..." run build
RUN pnpm --filter @acme/api deploy --prod /out
 
FROM node:24-slim
ENV NODE_ENV=production
WORKDIR /app
COPY --from=build /out .
USER node
EXPOSE 3000
CMD ["node", "dist/main.js"]