npm – Resumen rápido

¿Qué es npm?

npm (Node Package Manager) es la herramienta de gestión de paquetes y automatización de proyectos para Node.js.

Permite instalar librerías, ejecutar scripts y gestionar dependencias de forma automática. Todo se configura mediante un archivo central llamado package.json.

---

Conceptos básicos

package.json

Es el archivo principal donde se define:

• Información del proyecto (name, version, description)
• Dependencias (dependencies y devDependencies)
• Scripts de ejecución
• Configuración de compilación o herramientas adicionales

Ejemplo básico:

{
  "name": "mi-proyecto",
  "version": "1.0.0",
  "description": "Proyecto de ejemplo"
}

---

Dependencias

Las librerías necesarias para el proyecto se declaran en package.json:

• "dependencies" → necesarias para ejecución
• "devDependencies" → necesarias solo para desarrollo

Ejemplo:

"dependencies": {
  "express": "^5.2.1",
  "mysql2": "^3.19.1"
}

Para instalarlas se ejecuta:

npm install

npm descargará automáticamente las librerías en la carpeta node_modules.

---

Scripts npm

Los scripts permiten automatizar tareas comunes, como ejecutar la aplicación, tests o compilaciones.

Ejemplo en package.json:

"scripts": {
  "start": "node app.js",
  "dev": "node app.js",
  "test": "echo \"Error: no test specified\" && exit 1"
}

Se ejecutan con:

npm run start   # o simplemente: npm start
npm run dev     # para desarrollo
npm run test    # ejecutar tests

---

Ciclo de vida / tareas comunes

Comando	Función
npm install	Instala las dependencias
npm start	Ejecuta la aplicación
npm run <script>	Ejecuta un script definido en package.json
npm test	Ejecuta los tests definidos
npm update	Actualiza las dependencias
npm uninstall	Elimina un paquete

---

Repositorios

npm descarga paquetes desde repositorios:

• Local → dentro de node_modules del proyecto
• Remoto → el registro público de npm (https://www.npmjs.com/)
• Privado → repositorios internos o privados

---

Estructura típica de un proyecto Node.js + Express

proyecto/
│
├── package.json
├── package-lock.json
├── node_modules/
└── src/
    ├── app.js
    ├── controllers/
    ├── services/
    ├── dao/
    └── models/

---

💡 Idea clave

npm sigue el principio "Convention over Configuration" de manera ligera: si respetas la estructura estándar de Node.js y defines tus scripts, necesitas muy poca configuración para ejecutar tu proyecto.

---

Fuentes: ChatGPT + Claude