Werkzeuge

Versionen und Updates

Jedes Release des Kits trägt eine Versionsnummer, jede Component ebenso. Du siehst, was sich geändert hat, und aktualisierst, wann du willst.

Auf dieser Seite

Versionsnummern#

Das Kit steht auf Version 1.1.4. Zwei Ebenen tragen eine Nummer nach dem Muster Major, Minor, Patch. Die Kit-Version zählt Releases, jede Component hat zusätzlich ihre eigene Version. Die Kit-Version folgt der größten Änderung eines Releases.

Stufe	Beispiel	Wofür
patch	1.0.0 → 1.0.1	Eine Korrektur, die Props bleiben gleich. Jederzeit aktualisieren.
minor	1.0.0 → 1.1.0	Etwas Neues, etwa eine Variante oder eine optionale Prop. Dein Code läuft weiter.
major	1.0.0 → 2.0.0	Eine Prop heißt anders oder wird Pflicht, oder eine Variante fällt weg. Zuerst das Changelog lesen.

Eine neue Component startet bei 1.0.0. Auf der Seite stehen neue Components und Varianten mit dem Hinweis Neu, geänderte mit Aktualisiert, jeweils mit der Kit-Version.

Changelog#

Jedes Release steht mit Datum und einem Satz je Änderung im Changelog, das neueste oben.

Sehen, was neu ist#

aiw outdated vergleicht die Components deines Projekts mit der Registry. Du siehst je Component alte und neue Version, die Stufe und den Satz aus dem Changelog. Dateien, die du selbst geändert hast, nennt es gesondert.

aiw outdated

Component	Installiert	Neu	Stufe	Was sich ändert
hero	1.0.0	1.1.0	minor	Neue Variante split-video.
faq	1.0.0	1.0.1	patch	Fokusring sitzt wieder am Rand.

Aktualisieren#

aiw update bringt alle Components auf den neuesten Stand, mit Namen nur die genannten. Je Datei zeigt es hinzugefügte und entfernte Zeilen, neue Abhängigkeiten kommen mit.

aiw update
aiw update hero faq --dry-run
aiw update hero --force

Neue Components eines Releases holst du wie immer mit aiw add, etwa aiw add @ai-website/multi-step-form. aiw update bringt die vorhandenen auf den neuen Stand.

Lockfile#

aiw add schreibt ui-kit.lock.json in dein Projekt. Darin steht je Component die Version, ein Hash ihres Inhalts, die Quelle, das Datum und der Hash jeder geschriebenen Datei. Daran erkennen aiw outdated und aiw update deine eigenen Änderungen. Leg die Datei mit ins Repository.

ui-kit.lock.json

{
  "lockfileVersion": 1,
  "components": {
    "hero": {
      "version": "1.0.0",
      "hash": "210d8d60ef4e1d27",
      "source": "https://ai-website.com/ui-kit/r/hero.json",
      "installed": "2026-10-20",
      "files": { "src/components/ui/hero.tsx": "c5da10fc63f443ab" }
    }
  }
}

Alle Optionen stehen bei aiw outdated und aiw update.