Aprende a crear y publicar tu propio paquete npm. Desde preparar el package.json hasta configurar el workflow de publicación, descubrirás cómo compartir tu código con la comunidad.
Publicar un paquete en npm es más fácil de lo que parece. Una vez que tu código está listo y el package.json bien configurado, publicarlo solo requiere un comando. Pero hay detalles importantes que debes conocer: versioning, scoped packages, y cómo actualizar correctamente.
En esta lección vas a aprender a preparar un paquete para publicación, configurar la información necesaria, publicar tu primera versión, y gestionar actualizaciones futuras.
Al terminar, tendrás tu propio paquete publicado en npm y entenderás el proceso completo.
Lo que necesitas antes de publicar.
Antes de publicar, asegúrate de que el package.json tiene: nombre único, versión inicial (siempre 1.0.0), descripción clara, punto de entrada (main), licencia, y keywords relevantes.
También es buena práctica tener un repositorio (repository) y un campo bugs con la URL de issues. Esto hace tu paquete más profesional y confiable.
El comando que lo cambia todo.
El comando para publicar es simple: npm publish. Pero antes, necesitas una cuenta de npm (gratuita). Si no tienes una, regístrate en npmjs.com.
Una vez logueado con npm login, npm publish envía tu paquete al registry. En segundos estará disponible para todo el mundo.
Paquetes con namespace personal.
Los scoped packages usan el formato @scope/nombre. Esto te da un namespace propio y evita conflictos de nombres. Para publicar un scoped package, necesitas una cuenta npm gratuita.
Los scoped packages pueden ser públicos (por defecto) o privados (requieren cuenta de pago, pero puedes tener ilimitados repositorios privados con npm Teams).
El ciclo de publicación continua.
Para actualizar, cambia la versión en package.json según semver (patch, minor, o major) y publica nuevamente. También puedes usar npm version para automatizar el incremento.
Nunca publiques la misma versión dos veces. Siempre incrementa.
Haz tu paquete más discoverable.
Un buen paquete tiene: README claro con ejemplos, licencia válida, repository URL, keywords relevantes, y código de calidad con tests.
También considera añadir badges de CI/CD, publicar en GitHub, y mantener un changelog.
Aprende a crear y publicar tu propio paquete npm. Desde preparar el package.json hasta configurar el workflow de publicación, descubrirás cómo compartir tu código con la comunidad.
Código del tema: npm publish
Lo que necesitas antes de publicar.
Antes de publicar, asegúrate de que el package.json tiene: nombre único, versión inicial (siempre 1.0.0), descripción clara, punto de entrada (main), licencia, y keywords relevantes.
También es buena práctica tener un repositorio (repository) y un campo bugs con la URL de issues. Esto hace tu paquete más profesional y confiable.
El comando que lo cambia todo.
El comando para publicar es simple: npm publish. Pero antes, necesitas una cuenta de npm (gratuita). Si no tienes una, regístrate en npmjs.com.
Una vez logueado con npm login, npm publish envía tu paquete al registry. En segundos estará disponible para todo el mundo.
# Iniciar sesión en npm
npm login
# Username, Password, Email
# Publicar el paquete
npm publishPaquetes con namespace personal.
Los scoped packages usan el formato @scope/nombre. Esto te da un namespace propio y evita conflictos de nombres. Para publicar un scoped package, necesitas una cuenta npm gratuita.
Los scoped packages pueden ser públicos (por defecto) o privados (requieren cuenta de pago, pero puedes tener ilimitados repositorios privados con npm Teams).
# Scoped package público
{
"name": "@mi-usuario/mi-paquete"
}
# Scoped package de organización
{
"name": "@mi-org/mi-paquete"
}
# Publicar scoped público
npm publish --access publicEl ciclo de publicación continua.
Para actualizar, cambia la versión en package.json según semver (patch, minor, o major) y publica nuevamente. También puedes usar npm version para automatizar el incremento.
Nunca publiques la misma versión dos veces. Siempre incrementa.
# Incrementar patch (1.0.0 → 1.0.1)
npm version patch
# Incrementar minor (1.0.0 → 1.1.0)
npm version minor
# Incrementar major (1.0.0 → 2.0.0)
npm version major
# Luego publicar
npm publishHaz tu paquete más discoverable.
Un buen paquete tiene: README claro con ejemplos, licencia válida, repository URL, keywords relevantes, y código de calidad con tests.
También considera añadir badges de CI/CD, publicar en GitHub, y mantener un changelog.