yarn add

Instala un paquete y las dependencias de dicho paquete.

Añadiendo dependencias

En general, un paquete es simplemente una carpeta con código y un archivo package.json que describe el contenido. Cuando quieras usar otro paquete, primero necesitas añadirlo a tus dependencias. Esto significa ejecutar yarn add [package-name] para instalarlo en su proyecto.

Esto también actualizará tu package.json y tu yarn.lock para que otros desarrolladores trabajando en el proyecto tengan las mismas dependencias que tú cuando utilicen yarn or yarn install.

La mayoría de los paquetes serán instalados del registro de npm, siendo referenciados simplemente por el nombre del paquete. Por ejemplo, yarn add react instalará el paquete de react desde el registro de npm.

Puedes especificar versiones de las siguientes formas:

  1. yarn add nombre-de-paquete instalará la “última” versión del paquete.
  2. yarn add nombre-del-paquete@1.2.3 instala la versión específica de un paquete del registro.
  3. yarn add nombre-del-paquete@tag instala un “tag” específico (ej. beta, next, o latest).

También puedes especificar los paquetes desde diferentes lugares:

  1. yarn add package-name instala el paquete del npm registry a menos que haya especificado en su package.json.
  2. yarn add file:/carpeta/local instala un paquete que es sistema de archivos local. Esto es útil para probar otros paquetes de suyo que no han sido publicados en el registro.
  3. yarn add file:/path/to/local/tarball.tgz instala un paquete tarball comprimido con gzip que se podría utilizar para compartir el paquete antes de publicar.
  4. yarn add <git remote url> instala un paquete desde un repositorio git.
  5. yarn add <git remote url>#<branch/commit/tag> instala un paquete de un repositorio git remoto en rama específica git, git commit o git tag.
  6. yarn add https://my-project.org/package.tgz instala un paquete desde un tarball comprimido con gzip.

Advertencias

Si usted ya ha utilizado un gestor de paquetes como npm anteriormente, quizas este buscando como agregar dependencias globales.

Para la vasta mayoría de los paquetes, es considerada una mala practica tener dependencias globales, ya que las mismas son implicitas. Es mucho mejor agregar todas sus dependencias localmente para que sean explicitas, y para que cualquiera que use su proyecto obtenga el mismo set de dependencias.

Si intenta utilizar una herramienta CLI que tiene un binario, puede acceder al mismo en su directorio ./node_modules/.bin. También puedes usar el comando global:

yarn global add <package...>

Comandos

yarn add <paquete...>

Esto instalará uno o más paquetes en tu sección dependencies.

yarn add <package...> [--dev/-D]

Al usar --dev o -D se instalará uno o más paquetes en tu sección devDependencies.

yarn add <package...> [--peer/-P]

Con --peer o -P, se instalarán uno o más paquetes en tu sección peerDependencies.

yarn add <package...> [--optional/-O]

Con --optional o -O, se instalará uno o más paquetes en tu sección optionalDependencies.

yarn add <package...> [--exact/-E]

Con --exact o -E instala los paquetes como versiones exactas. Lo predeterminado es utilizar la versión más reciente con la misma versión principal. Por ejemplo, yarn add foo@1.2.3 aceptaría la versión 1.9.1, pero yarn add foo@1.2.3 --exact sólo aceptaría la versión 1.2.3.

yarn add <package...> [--tilde/-T]

Con --tilde o -T se instalará la versión más reciente de los paquetes que tienen la misma versión menor. Lo predeterminado es utilizar la versión más reciente con la misma versión principal. Por ejemplo, yarn add foo@1.2.3 --tilde aceptaría la versión 1.2.9 pero no la 1.3.0.