añadir
npx blockstudio add <blocks...> [options]
Descarga bloques de un registro y los guarda en el directorio de bloques de tu proyecto.
Argumentos
| Argumento | Descripción |
|---|---|
blocks |
Uno o más bloques para añadir. Formato: namespace/block o simplemente block. |
Opciones
| Opción | Descripción |
|---|---|
-y, --yes |
Omite todas las indicaciones (sobrescritura, resolución de conflictos). |
--dry-run |
Muestra una vista previa de lo que se instalaría sin escribir archivos. |
Resolución de espacios de nombres
Al especificar un espacio de nombres, CLI busca en ese registro específico:
npx blockstudio add ui/tabs
Si omites el espacio de nombres, CLI busca en todos los registros configurados:
npx blockstudio add tabs
Si el bloque se encuentra en un solo registro, se usa automáticamente. Si aparece en varios, CLI muestra una selección interactiva para elegir.
Con --yes, se usa el primer registro coincidente según el orden de blocks.json.
Sin una terminal y con --dry-run, un nombre ambiguo detiene el comando con un error que enumera los registros:
Block "hero" found in multiple registries: acme, starter. Specify one: blockstudio add acme/hero
Antes de resolver cualquier bloque, add obtiene todos los registros configurados. Si alguno no está disponible o no es válido, el comando falla, incluso si el bloque tiene un espacio de nombres explícito.
Dependencias
Los bloques pueden declarar dependencias de otros bloques del mismo registro. Al añadir un bloque, sus dependencias se resuelven e instalan automáticamente.
npx blockstudio add ui/tabs
Si tabs depende de tab-item, ambos bloques se descargan e instalan.
Las dependencias siempre se instalan antes que los bloques que dependen de ellas.
Las dependencias circulares se detectan y se rechazan con un error.
Comportamiento al sobrescribir
Si ya existe una carpeta de bloque en el directorio de destino:
- Modo interactivo: te pide confirmar la sobrescritura
- Indicador
--yes: sobrescribe sin preguntar - Indicador
--dry-run: informa qué se sobrescribiría - Modo no interactivo sin
--yes: se detiene antes de descargar, conBlock "<name>" already exists at <path>. Use --yes to overwrite.
La comprobación también incluye las dependencias, así que para añadir tabs cuando tab-item ya está instalado se necesita --yes.
Varios bloques
Los bloques pasados en un mismo comando se procesan en orden. Si alguno falla, el comando se detiene ahí y los bloques instalados antes durante la misma ejecución permanecen en el disco.
Ejemplos
Añadir un solo bloque:
npx blockstudio add ui/hero
Añadir varios bloques:
npx blockstudio add ui/tabs ui/hero ui/accordion
Vista previa sin escribir:
npx blockstudio add ui/tabs --dry-run
Omitir todas las indicaciones:
npx blockstudio add ui/tabs --yes