~/VibeHandbook
PDF gratis

Capítulo 05 · 04

Paquetes y dependencias

Nadie escribe una aplicación completa desde cero. Los problemas difíciles y comunes — dar formato a fechas, gestionar pagos, renderizar un calendario — ya han sido resueltos y empaquetados por otras personas. Un es un fragmento de código reutilizable que incorporas a tu proyecto en lugar de escribirlo tú mismo. Las dependencias de tu proyecto son la lista de paquetes de los que depende.

En el mundo de JavaScript, la herramienta que gestiona esto es npm (Node Package Manager, Gestor de Paquetes de Node). Dos archivos llevan la contabilidad:

  • package.json — la lista legible para humanos de lo que tu proyecto necesita, más los comandos para ejecutarlo. Tú (o la IA) editan esto.
  • el archivo de bloqueo (package-lock.json o similar) — un registro exacto, generado por máquina, de cada paquete y su versión precisa, para que la aplicación se construya de manera idéntica en tu máquina, en la de un compañero de equipo y en el servidor. No lo editas a mano; dejas que la herramienta lo gestione.
{
  "name": "my-app",
  "scripts": {
    "dev": "next dev",
    "build": "next build"
  },
  "dependencies": {
    "next": "16.0.0",
    "react": "19.0.0"
  }
}

¿Por qué importa? Cuando la IA dice "agreguemos una librería para esto", está editando package.json y tú estás confiando en el código de otra persona — pocas dependencias bien conocidas son más seguras que un montón de dependencias oscuras. Y cuando una compilación se rompe misteriosamente, una desajustada es un sospechoso habitual, donde "eliminar y reinstalar los paquetes" es una solución real y común.

¿Lo quieres sin conexión?

Descarga el libro entero en PDF o EPUB — gratis.