Instala las librerías de Angular con ng add | ng-hub-ui

El instalador de la familia ng-hub-ui: una orden ng add que pregunta qué librerías quieres, resuelve los paquetes que necesita cada una y los escribe en tu manifiesto.

Última actualización 8 sept 2026

Visión General

Por qué los equipos buscan esta librería

Usa ng-hub-ui cuando vayas a añadir una o varias librerías de la familia a un espacio de trabajo de Angular y prefieras no averiguar a mano qué paquete par necesita cada una.

Instalación

ng add ng-hub-ui

Ir a

Ideal para

  • Añadir varias librerías de ng-hub-ui a un espacio de trabajo de Angular de una vez
  • Automatizar la puesta en marcha de un proyecto en CI sin contestar a un diálogo
  • Dejar que se calculen por ti los paquetes pares que necesita cada librería

Sobre ui

ng-hub-ui es el paquete paraguas de la familia y el único publicado que no trae componentes. Lo que trae es un esquema ng-add. Ofrece las 25 librerías del catálogo en un diálogo de selección múltiple, o toma sus identificadores directamente de la opción --libraries, y resuelve la selección en los paquetes de npm que de verdad hacen falta: los pares de los que depende cada librería y el único paquete externo, sortablejs, que no es nuestro. La lista resuelta se escribe en dependencies, en la raíz del espacio de trabajo, sin sobrescribir nunca una clave que ya esté, y se entrega al gestor de paquetes que la CLI de Angular haya detectado. Su alcance termina en el cableado de dependencias: no toca angular.json, ni registra proveedores, ni importa componentes, ni añade hojas de estilo.

Guías de uso

Una sola orden

`ng add ng-hub-ui` es toda la instalación. La CLI de Angular descarga el paquete, ejecuta su esquema `ng-add` y este pregunta cuáles de las 25 librerías del catálogo quieres. El espacio selecciona, `a` marca todas e `i` invierte la selección; al confirmar, la elección se resuelve en paquetes de npm, se escriben en `dependencies` y la instalación pasa al gestor de paquetes que la CLI haya detectado.

Ejemplos:
Instalación interactiva

La orden y el diálogo que abre, tal y como aparecen en la terminal.

Space selects, a toggles everything and i inverts the selection. The schematic writes the chosen packages into dependencies and then lets the package manager install them.

Opciones y scripts

El diálogo se puede saltar, que es lo que hace al instalador utilizable desde CI y desde el script de arranque de un proyecto. `--libraries` acepta una lista separada por comas o la misma opción repetida, y ambas formas se normalizan igual: sin espacios, sin duplicados y en el orden en que se dieron. `--skip-install` escribe el manifiesto y se detiene ahí. Pasa los identificadores del catálogo, no las etiquetas que muestra el diálogo — son cadenas distintas, y una desconocida detiene el esquema antes de tocar `package.json`.

Ejemplos:
Opciones en lugar del diálogo

Las tres formas no interactivas y las dos maneras en que se rechaza una selección incorrecta.

Comma-separated

Repeated flag — the same selection, normalized the same way

Manifest only, install left to you

An empty selection fails with Select at least one ng-hub-ui library to install. and an unknown identifier with Unknown ng-hub-ui library: <id>. — in both cases before package.json is touched.

Dependencias resueltas

Lo que se selecciona no es lo que se escribe. Cada librería del catálogo declara los pares que necesita —`ng-hub-ui-utils` para casi toda la familia, `ng-hub-ui-ds` para panels, `ng-hub-ui-forms` para signature y `sortablejs`, que ni siquiera es nuestro— y la resolución es transitiva, así que una librería añadida de rebote aporta a su vez sus propios pares. Cada rango parte de un suelo igual o superior al par más alto que la familia le exige, que es lo que evita escribir una pareja que npm no puede satisfacer. Una clave que ya existe nunca se reescribe, así que una versión fijada sobrevive. El esquema se detiene en el cableado de dependencias: no toca `angular.json`, ni proveedores, ni registros de componentes, ni hojas de estilo.

Ejemplos:
Lo que escribe la selección

Dos librerías pedidas, cinco paquetes escritos: las dependencias añadidas de rebote, en concreto.

Two libraries asked for…

…five packages written into package.json

The schematic adds a dependency only when the key is absent, so a version already pinned in your manifest survives the install untouched.

Características clave

Cambios recientes

Version 0.2.1 - 9/8/26, 12:00 AM

fixed: Four documents said the installer has no page on the documentation site. This is that page: both READMEs and `FUNCTIONALITIES.md` link to it instead of denying it.

changed: The manifest `homepage` points at this page rather than at the family root — it is the link a registry shows beside the package, and every other library in the family already points at its own documentation. Metadata only: no code, no schematic behaviour, no catalogue change.

Version 0.2.0 - 9/6/26, 12:00 AM

fixed: Every one of the 25 catalogue ranges now floors at or above the highest peer the family declares on it. `ng-hub-ui-forms` had reached 22.32.0 peering on `ng-hub-ui-utils >=22.12.0` while the catalogue still offered `utils ^22.8.1`, so `ng add ng-hub-ui --libraries=forms` wrote a pair npm cannot satisfy — invisible on a fresh unpinned install, an `ERESOLVE` anywhere resolution was already fixed.

fixed: Both READMEs denied a library the installer has offered since 0.1.6: they said `ng-hub-ui-action-sheet` was not on npm, in five separate places, while the catalogue had carried it all along.

changed: The Angular peer range is `>=18.0.0`, up from `>=17.3.0`. Nothing in the catalogue targets Angular 17, so the old floor let `ng add ng-hub-ui` run, write the manifest and only then fail to resolve. See `BREAKING_CHANGES.md`.

added: The schematic has a tracked spec again. The only test over `ng add` lived beside the compiled output where `.gitignore` excludes it, so it left the repository the moment it was written; run today it reported three failures it had been reporting for months.

Version 0.1.7 - 9/1/26, 12:00 AM

changed: The manifest `homepage` points at the localized site root rather than the redirect above it, so a reader arriving from npm lands one hop earlier.

Version 0.1.6 - 8/30/26, 12:00 AM

added: `action-sheet` joins the catalogue and the prompt: `ng-hub-ui-action-sheet` reached the registry with 22.0.0, and it needs no co-installs.

Preguntas frecuentes

¿Cómo instalo ng-hub-ui en un proyecto de Angular?

Ejecuta ng add ng-hub-ui. La CLI de Angular descarga el paquete instalador y ejecuta su esquema ng-add, que pregunta cuáles de las 25 librerías del catálogo quieres, escribe los paquetes resueltos en dependencies y deja que tu gestor de paquetes los instale.

¿Puedo instalar las librerías sin el diálogo interactivo?

Sí. Pasa los identificadores a --libraries, separados por comas (--libraries=modal,paginable) o repitiendo la opción (--libraries=modal --libraries=paginable). Añade --skip-install para actualizar package.json y dejarte a ti la instalación.

¿Qué cambia el esquema de ng-hub-ui en mi proyecto?

Solo el bloque dependencies del package.json de la raíz, y solo las claves que aún no estén. No toca angular.json, ni registra proveedores, ni importa componentes, ni añade hojas de estilo.