Frontend Academy · Les

Versiebeheer en publiceren naar npm

Gebruik semantic versioning, automatiseer het genereren van changelogs met Changesets of standard-version en publiceer de library naar npm of een private registry.

Les 3 van 415 stappen

Versiebeheer en publiceren naar npm 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 publiceren naar npm?

Als je ontwerpsysteem door meer dan één app wordt gebruikt, publiceer je het als pakket. Gebruikers installeren het met npm/yarn/pnpm, vergrendelen versies en werken bij wanneer het hun uitkomt.

Semantische versiebeheer (SemVer)

Versies volgen MAJOR.MINOR.PATCH. MAJOR: wijzigingen die bestaande code breken. MINOR: nieuwe functies, achterwaarts compatibel. PATCH: alleen foutoplossingen.

Wanneer je het versienummer verhoogt

Een prop hernoemd? MAJOR. Een nieuwe optionele prop toegevoegd? MINOR. Een CSS-fout opgelost? PATCH. Releases vóór 1.0 (0.x.y) kunnen bij MINOR wijzigingen bevatten die bestaande code breken — maar wees zorgvuldig.

package.json — het manifest

Configureer hoe je pakket eruitziet op npm.

{
  "name": "@yourorg/design-system",
  "version": "1.4.2",
  "main": "dist/index.cjs.js",
  "module": "dist/index.esm.js",
  "types": "dist/index.d.ts",
  "exports": {
    ".": { "import": "./dist/index.esm.js", "require": "./dist/index.cjs.js" },
    "./theme": "./dist/theme.js"
  },
  "files": ["dist", "README.md"],
  "peerDependencies": { "react": "^18.0.0" }
}

Bouwuitvoer

Lever CommonJS, ESM en typeverklaringen. Tools zoals tsup of vite build --lib regelen dit.

// tsup.config.ts
export default {
  entry: ['src/index.ts'],
  format: ['cjs', 'esm'],
  dts: true,
  clean: true,
  external: ['react', 'react-dom']
};

// package.json: "build": "tsup"

peerDependencies

Vermeld React, Vue enzovoort als peerDependencies, zodat gebruikers hun eigen versie gebruiken. Als je ze als gewone afhankelijkheden markeert, worden ze twee keer gebundeld — kapotte hooks en kapotte context.

Geschikt voor tree-shaking

Gebruik ESM-exports en vermijd bijwerkingen, zodat bundelaars ongebruikte componenten kunnen verwijderen. Markeer dit in package.json: "sideEffects": false (of vermeld specifieke bestanden, zoals CSS).

Naar npm publiceren

Log één keer in en publiceer daarna.

npm login

# Bump version + publish:
npm version patch   # 1.4.2 -> 1.4.3
npm publish

# Or scoped public package:
npm publish --access public

Releases automatiseren met Changesets

Changesets is de moderne gereedschapskist voor het publiceren van monorepo's en bibliotheken. Pull requests bevatten een 'changeset'-bestand waarin de wijziging wordt beschreven; de release-automatisering verhoogt de versies en publiceert ze.

npm install -D @changesets/cli
npx changeset init

# In each PR:
npx changeset
# pick package, type (major/minor/patch), describe change
# commits .changeset/<random>.md

# CI on main:
npx changeset version  # bumps versions in package.json + generates changelog
npx changeset publish  # publishes to npm

Automatisch wijzigingslogboek

Changesets genereert automatisch voor elk pakket een CHANGELOG.md op basis van de beschrijvingen in de changesets — gebruikers kunnen lezen wat er in elke versie is gewijzigd.

npm-dist-tags

Gebruik dist-tags voor voorafgaande versies: npm publish --tag beta publiceert zonder latest te overschrijven. Gebruikers kiezen hiervoor met npm install @yourorg/design-system@beta.

Privéregisters

Interne pakketten kunnen GitHub Packages, GitLab Package Registry of het zelf gehoste Verdaccio gebruiken. Configureer dit met .npmrc: @yourorg:registry=https://npm.pkg.github.com.

Oude versies afschrijven

Markeer een versie als afgeschreven om gebruikers die haar installeren te waarschuwen.

npm deprecate @yourorg/design-system@1.0.0 'Use 2.x for React 18 support'

Korte controle

Als je een prop van een geëxporteerde component hernoemt, welke verhoging van het SemVer-versienummer is dan vereist?

Beantwoord dit in de interactieve les

Samenvatting: versiebeheer en publiceren

SemVer: MAJOR.MINOR.PATCH — brekende wijziging, functie, oplossing. Bouw CJS + ESM + typen (tsup, vite --lib). Gebruik React/Vue als peerDependencies. sideEffects:false voor tree-shaking. Publiceer met npm publish of automatiseer dit met Changesets. CHANGELOG wordt automatisch gegenereerd. Dist-tags voor bèta's. Privéregisters voor interne pakketten.

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 “Versiebeheer en publiceren naar npm” gratis?

Ja — de volledige tekst van “Versiebeheer en publiceren naar npm” 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 “Versiebeheer en publiceren naar npm”?

Gebruik semantic versioning, automatiseer het genereren van changelogs met Changesets of standard-version en publiceer de library naar npm of een private registry. 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 “Versiebeheer en publiceren naar npm”?

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