Repolode
Enviar
sindresorhus

sindresorhus/np

Una CLI que envuelve npm publish e integra comprobaciones previas a la versión, actualización de versión, etiquetas de git, pruebas y pushes para publicar en un único proceso interactivo.

Ver en GitHub
Estrellas
7,710
Forks
311
Issues abiertos
7
Último commit
el mes pasado

¿Qué es?

np es una herramienta de línea de comandos que sustituye la secuencia manual habitual para publicar un paquete de npm. Ejecútala desde un proyecto y comprobará que estés en la rama de publicación, que el directorio de trabajo esté limpio y actualizado respecto al remoto, y que las versiones de Node.js y npm coincidan con las que admite el proyecto. Después, reinstala las dependencias, ejecuta las pruebas, actualiza la versión en package.json y package-lock.json, crea una etiqueta de git y publica en npm.

Si falla la publicación, np restaura el proyecto a su estado anterior. Tras publicar correctamente, envía los commits y las etiquetas a GitHub o GitLab y puede abrir un borrador de GitHub Releases con los campos rellenados. También impide publicar por accidente versiones preliminares con la etiqueta dist-tag latest, admite la autenticación de dos factores y ofrece un modo dry-run que muestra todos los pasos sin ejecutarlos.

np funciona con npm, pnpm, Bun y Yarn, y permite publicar en GitHub Packages o en un registro personalizado. Está pensado para el uso interactivo en local, no para CI, y no admite monorepositorios.

Funciones clave

  • 01Comprueba la rama de publicación, que el árbol de trabajo esté limpio y que no haya cambios pendientes de traer antes de publicar.
  • 02Actualiza las versiones en package.json y package-lock.json y crea una etiqueta de git.
  • 03Ejecuta las pruebas y restaura el proyecto si falla la publicación.
  • 04Envía commits y etiquetas a GitHub o GitLab y puede abrir un borrador de publicación.
  • 05Ofrece una interfaz interactiva y un modo dry-run.
  • 06Admite npm, pnpm, Bun y Yarn, además de GitHub Packages.

Casos de uso

  • Publicar una biblioteca en npm desde una máquina local con un proceso de publicación coherente y verificado.
  • Estandarizar las publicaciones de un equipo añadiendo np como script de publicación en package.json.
  • Publicar versiones preliminares con una etiqueta dist-tag independiente, como beta, sin poner en riesgo la etiqueta latest.
  • Publicar un paquete privado desde un repositorio git omitiendo el paso de npm publish.

Inicio rápido

  1. 1

    Instala np globalmente con npm

    npm install --global np
  2. 2

    Ejecuta np en tu proyecto y sigue las indicaciones interactivas

    np

Antes de usarlo

  • No se admiten monorepos.
  • CI no es un entorno ideal; está pensado para usarse localmente como herramienta interactiva.
  • Requiere Node.js 22 o posterior, npm 10 o posterior y Git 2.11 o posterior.

En colecciones

Herramientas de CLI y terminal

Temas

#npm#cli#publish#release-management#git#nodejs#version-bump#cli-app#javascript#npm-package

Preguntas frecuentes

¿Qué es np?
Una CLI que envuelve npm publish e integra comprobaciones previas a la versión, actualización de versión, etiquetas de git, pruebas y pushes para publicar en un único proceso interactivo. np es una herramienta de línea de comandos que sustituye la secuencia manual habitual para publicar un paquete de npm. Ejecútala desde un proyecto y comprobará que estés en la rama de publicación, que el directorio de trabajo esté limpio y actualizado respecto al remoto, y que las versiones de Node.js y npm coincidan con las que admite el proyecto. Después, reinstala las dependencias, ejecuta las pruebas, actualiza la versión en package.json y package-lock.json, crea una etiqueta de git y publica en npm.
¿np es gratuito? ¿Qué licencia tiene?
np es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿np sigue mantenido?
Actualizado en los últimos 6 meses. El último commit de np fue el 9 sept 2026.
¿Para qué puedo usar np?
Publicar una biblioteca en npm desde una máquina local con un proceso de publicación coherente y verificado. Estandarizar las publicaciones de un equipo añadiendo np como script de publicación en package.json. Publicar versiones preliminares con una etiqueta dist-tag independiente, como beta, sin poner en riesgo la etiqueta latest. Publicar un paquete privado desde un repositorio git omitiendo el paso de npm publish.
¿Cómo se instala np?
Instala np globalmente con npm: npm install --global np Ejecuta np en tu proyecto y sigue las indicaciones interactivas: np
¿Dónde consigo np?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/sindresorhus/np

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados