Frontend Academy · Les

pnpm-workspaces voor monorepo's

Stel een pnpm-workspace in met een pnpm-workspace.yaml in de root, lift gedeelde afhankelijkheden naar boven en gebruik het workspace:-protocol om lokale packages te koppelen.

Les 3 van 415 stappen

pnpm-workspaces voor monorepo's is een gratis Frontend Academy-les op CoddyKit. Dit is les 3 van 4. Je kunt de volledige les hieronder gratis lezen en daarna in de browser praktisch oefenen met een ingebouwde code-editor en een AI-begeleider die 24/7 beschikbaar is. Deze les maakt deel uit van het leertraject Frontend Academy. Je voortgang wordt gesynchroniseerd op het web en in de CoddyKit-app. De cursus Frontend Academy bevat in totaal 4 lessen.

Waarom pnpm?

pnpm (Performant npm) is een snelle, schijfzuinige pakketbeheerder. Het slaat één exemplaar van elk pakket op in een globale inhoudsadresseerbare opslag en maakt vanuit de node_modules van projecten koppelingen daarnaartoe. Dezelfde afhankelijkheid in meerdere projecten betekent dus één exemplaar op schijf.

Snelheid en schijfruimtebesparing

In een typische monorepo zijn installaties met pnpm 2-3x sneller dan met npm/yarn en gebruiken ze ongeveer 70% minder schijfruimte. Dat levert enorme voordelen op voor monorepo's met veel pakketten.

pnpm installeren

Gebruik Corepack (meegeleverd met Node 16+) of installeer pnpm globaal.

# Corepack (recommended):
corepack enable
corepack prepare pnpm@latest --activate

# Or:
npm install -g pnpm

Werkruimte instellen

Maak in de hoofdmap een pnpm-workspace.yaml waarin je de mappen met pakketten opsomt.

# pnpm-workspace.yaml
packages:
  - 'apps/*'
  - 'packages/*'
  - '!**/test/**'

Projectstructuur

Elke app en elk pakket heeft een eigen package.json. De hoofdmap heeft een package.json voor de werkruimte met gedeelde devDeps.

my-monorepo/
  pnpm-workspace.yaml
  package.json         (root, private: true)
  apps/
    web/
      package.json
    docs/
      package.json
  packages/
    ui/
      package.json
    config-eslint/
      package.json

Afhankelijkheden installeren

Voer eenmaal pnpm install uit in de hoofdmap. pnpm installeert alles in alle pakketten en haalt gemeenschappelijke afhankelijkheden naar boven.

pnpm install

# Install only in one workspace:
pnpm --filter web add react-router-dom

# Install dev dep at root:
pnpm add -Dw typescript prettier

workspace:-protocol

Verwijs met workspace:* naar interne pakketten. pnpm verwijst dan naar het lokale pakket; bij het publiceren wordt dit vervangen door een echte versie.

// apps/web/package.json
{
  "dependencies": {
    "@repo/ui": "workspace:*",
    "@repo/utils": "workspace:^1.0.0"
  }
}

// On publish, workspace:* becomes the actual version of @repo/ui.

Scripts in alle pakketten uitvoeren

pnpm -r voert een script uit in elk pakket. Gebruik --filter voor deelverzamelingen.

# Run build in every package:
pnpm -r build

# Only in web and its deps:
pnpm --filter web... build

# Run lint in changed packages since main:
pnpm --filter ...[origin/main] lint

Strikte afhankelijkheidsresolutie

Standaard gebruikt pnpm symbolische koppelingen, zodat een pakket alleen de afhankelijkheden ziet die het expliciet in zijn package.json heeft vermeld. Er lekken dus geen afhankelijkheden uit andere pakketten — een fout die zowel npm als klassiek yarn toestaat.

Hoistpatronen

Standaard voert pnpm geen hoisting uit. Als een indirecte afhankelijkheid toegankelijk moet zijn (bijvoorbeeld een globaal beschikbare TypeScript), voeg je aan .npmrc toe: shamefully-hoist=true (vermijd dit indien mogelijk) of gebruik een specifiek public-hoist-pattern.

Afhankelijkheden bijwerken

pnpm update werkt bij binnen semver-bereiken. pnpm update -L werkt bij naar de nieuwste versie (en negeert het dakje).

pnpm update                      # update all
pnpm --filter web update react   # only react, only web
pnpm update -L                   # latest (ignore caret)

Combineren met Turborepo

pnpm levert de werkruimte en installatie; Turborepo levert taakorkestratie en caching. Ze vullen elkaar perfect aan — de meeste JavaScript-monorepo's gebruiken beide.

# pnpm install dependencies
pnpm install

# Turborepo runs the tasks across the workspace:
pnpm turbo run build --filter=web...

CI-tips

Cache de inhoudsadresseerbare opslag van pnpm (~/.local/share/pnpm/store) voor snellere CI. Gebruik --frozen-lockfile om te zorgen dat de opdracht faalt als pnpm-lock.yaml zou veranderen.

# .github/workflows/ci.yml
- uses: pnpm/action-setup@v3
  with: { version: 9 }
- uses: actions/setup-node@v4
  with: { node-version: '20', cache: 'pnpm' }
- run: pnpm install --frozen-lockfile
- run: pnpm -r build

Kennischeck

Wat is het belangrijkste voordeel van pnpm ten opzichte van npm/yarn voor schijfruimte in een monorepo?

Beantwoord dit in de interactieve les

Samenvatting: pnpm-werkruimtes

Één inhoudsadresseerbare opslag + symbolische koppelingen = snelle installaties en ongeveer 70% minder schijfruimte. pnpm-workspace.yaml bevat de mappen met pakketten. Het workspace:*-protocol is voor interne afhankelijkheden. pnpm -r voert scripts uit in alle pakketten; --filter voor deelverzamelingen. Strikte resolutie voorkomt lekkende afhankelijkheden. Combineer het met Turborepo voor taakorkestratie. Gebruik --frozen-lockfile in CI.

Gratis beginnen

Leer HTML met een AI-tutor — gratis

Schrijf echte code en voer die uit in je browser, krijg direct hulp van een AI-tutor die 24/7 beschikbaar is en ga verder waar je gebleven bent op het web of in de app.

Cursussen: 41
Lessen: 163

Gratis beginnen met leren Bekijk de volledige cursus

Veelgestelde vragen

Is de les “pnpm-workspaces voor monorepo's” gratis?

Ja — de volledige tekst van “pnpm-workspaces voor monorepo's” kun je hier gratis op het web lezen. Als je interactief wilt oefenen met een ingebouwde code-editor en een AI-begeleider die 24/7 beschikbaar is, en de rest van de cursus Frontend Academy wilt ontgrendelen, kun je upgraden naar CoddyKit PRO. De cursus Frontend Academy bevat in totaal 4 lessen.

Wat leer ik in “pnpm-workspaces voor monorepo's”?

Stel een pnpm-workspace in met een pnpm-workspace.yaml in de root, lift gedeelde afhankelijkheden naar boven en gebruik het workspace:-protocol om lokale packages te koppelen. Je oefent met Frontend Academy door code rechtstreeks in de browser uit te voeren. Een AI-begeleider die 24/7 beschikbaar is beantwoordt je vragen terwijl je de les doorwerkt.

Heb ik ervaring nodig om met Frontend Academy te beginnen?

Ervaring vooraf is niet nodig. Frontend Academy op CoddyKit is opgebouwd voor beginners tot gevorderden, zodat je hier of bij het begin kunt starten en in je eigen tempo kunt leren. Dit is les 3 van 4.

Hoe lang duurt de les “pnpm-workspaces voor monorepo's”?

De meeste lessen van CoddyKit duren ongeveer 5–10 minuten. Elke les is kort en interactief, zodat je gestaag vooruitgaat en op het web en in de app precies verdergaat waar je was gebleven.

Kan ik code schrijven en uitvoeren in deze les over Frontend Academy?

Ja. Elke les over Frontend Academy bevat een ingebouwde code-editor, zodat je rechtstreeks in je browser echte code kunt schrijven en uitvoeren en direct feedback van AI krijgt — lokale installatie is niet nodig.

Alle lessen in deze cursus

← Terug naar Frontend Academy