Zum Inhalt springen

hinzufügen

Shell
npx blockstudio add <blocks...> [options]

Lädt Blöcke aus einer Registry herunter und schreibt sie in das Blockverzeichnis deines Projekts.

Argumente

Argument Beschreibung
blocks Ein oder mehrere hinzuzufügende Blöcke. Format: namespace/block oder einfach block.

Optionen

Option Beschreibung
-y, --yes Alle Eingabeaufforderungen überspringen (Überschreiben, Konfliktlösung).
--dry-run Zeige vorab an, was installiert würde, ohne Dateien zu schreiben.

Namensraumauflösung

Wenn du einen Namensraum angibst, sucht der CLI in der angegebenen Registry:

Shell
npx blockstudio add ui/tabs

Wenn du keinen Namensraum angibst, durchsucht der CLI alle konfigurierten Registries:

Shell
npx blockstudio add tabs

Wird der Block in genau einer Registry gefunden, wird er automatisch verwendet. Wird er in mehreren gefunden, zeigt der CLI eine interaktive Auswahl an.

Mit --yes wird die erste passende Registry in der Reihenfolge von blocks.json verwendet. Ohne Terminal und mit --dry-run bricht der Befehl bei einem mehrdeutigen Namen mit einer Fehlermeldung ab, die die Registries auflistet:

Code
Block "hero" found in multiple registries: acme, starter. Specify one: blockstudio add acme/hero

Bevor der add einen Block auflöst, ruft er alle konfigurierten Registries ab. Ist eine davon nicht erreichbar oder ungültig, schlägt der Befehl fehl – auch bei einem Block mit explizitem Namensraum.

Abhängigkeiten

Blöcke können Abhängigkeiten zu anderen Blöcken in derselben Registry festlegen. Wenn du einen Block hinzufügst, werden seine Abhängigkeiten automatisch aufgelöst und installiert.

Shell
npx blockstudio add ui/tabs

Wenn tabs von tab-item abhängt, werden beide Blöcke heruntergeladen und installiert. Abhängigkeiten werden immer vor den Blöcken installiert, die von ihnen abhängen.

Zyklische Abhängigkeiten werden erkannt und mit einer Fehlermeldung abgelehnt.

Verhalten beim Überschreiben

Wenn im Zielverzeichnis bereits ein Blockordner vorhanden ist:

  • Interaktiver Modus: Du wirst gefragt, ob du das Überschreiben bestätigen möchtest
  • --yes-Flag: überschreibt ohne Nachfrage
  • --dry-run-Flag: zeigt an, was überschrieben würde
  • Nicht-interaktiver Modus ohne --yes: bricht vor dem Download ab, mit Block "<name>" already exists at <path>. Use --yes to overwrite.

Die Prüfung berücksichtigt auch Abhängigkeiten. Wenn tab-item bereits installiert ist, brauchst du zum Hinzufügen von tabs also --yes.

Mehrere Blöcke

Blöcke, die in einem Befehl übergeben werden, werden der Reihe nach verarbeitet. Schlägt einer fehl, wird der Befehl an dieser Stelle abgebrochen. Blöcke, die während desselben Durchlaufs zuvor installiert wurden, bleiben auf der Festplatte.

Beispiele

Einen einzelnen Block hinzufügen:

Shell
npx blockstudio add ui/hero

Mehrere Blöcke hinzufügen:

Shell
npx blockstudio add ui/tabs ui/hero ui/accordion

Vorschau ohne Schreibvorgang:

Shell
npx blockstudio add ui/tabs --dry-run

Alle Eingabeaufforderungen überspringen:

Shell
npx blockstudio add ui/tabs --yes