npm: fundamentos, gestor de paquetes para React Native y Node.js

¿Qué es npm — el gestor de paquetes de Node.js?

npm fue creado en 2010 por Isaac Schlueter como una solución para gestionar dependencias de Node.js. Desde 2014, npm es gestionado por npm, Inc., adquirida por Microsoft/GitHub en 2020. La herramienta consta de dos partes: la CLI (línea de comandos) para instalar y gestionar paquetes, y el Registry, el repositorio central de todos los módulos publicados en registry.npmjs.org.

npm Registry es el registro de paquetes más grande: más de 2 millones de paquetes y más de 10 mil millones de descargas mensuales. Cada paquete tiene una versión SemVer, descripción, dependencias, licencia y autoría. La publicación de su propio paquete se realiza mediante npm publish. npm admite paquetes con ámbito para organizaciones (@scope/package), registros privados y auditoría de seguridad integrada.

Node.js versión 18+ incluye npm 9+ con rendimiento mejorado, workspaces para monorepositorios y un mecanismo de dependencias pares rediseñado. El ecosistema npm abarca JavaScript del lado del servidor, frontend (React, Vue, Angular), desarrollo móvil (React Native), herramientas de compilación (Webpack, Vite) y utilidades CLI. npm es el canal principal de distribución de librerías JavaScript.

Funcionalidades principales de npm

npm install — el comando principal que lee package.json y package-lock.json para instalar todas las dependencias en node_modules. En la primera ejecución, npm calcula el grafo de dependencias, resuelve conflictos de versiones y genera package-lock.json. El comando npm install <package> instala un paquete específico; la bandera --save-dev lo añade a devDependencies, --global lo instala globalmente.

npx — un ejecutor de paquetes incluido en npm desde la versión 5.2. npx permite ejecutar utilidades CLI sin instalación global: npx react-native init o npx create-react-app my-app. npx descarga el paquete en una caché temporal, lo ejecuta y lo limpia al finalizar. npx también es útil para ejecutar versiones específicas de herramientas.

npm audit escanea el árbol de dependencias en busca de vulnerabilidades conocidas de la base de datos de npm. El comando genera un informe con niveles de criticidad (critical, high, moderate) y recomienda npm audit fix para actualizar automáticamente los paquetes vulnerables. npm cache almacena los paquetes descargados localmente. npm cache clean --force limpia la caché cuando hay problemas de instalación. npm outdated muestra los paquetes desactualizados.

# Comandos básicos de npm
$ npm install
$ npm install react-native-webview --save
$ npm install typescript --save-dev
# Ejecución sin instalación global
$ npx react-native init MyApp
# Auditoría de seguridad
$ npm audit --fix

Estructura de package.json y gestión de dependencias

package.json es un archivo JSON en la raíz del proyecto que describe sus metadatos, dependencias y configuración. Campos obligatorios: name (nombre único del paquete) y version (versión SemVer, por ejemplo 1.0.0). El archivo se crea con npm init -y para una inicialización rápida o manualmente.

Semantic Versioning (SemVer) es un estándar de versionado en formato MAJOR.MINOR.PATCH. La versión mayor cambia con cambios incompatibles de API, la menor al añadir funcionalidad (compatible hacia atrás), y el parche al corregir errores. El símbolo ^ antes de la versión permite actualizaciones menores y de parche, mientras que ~ solo permite actualizaciones de parche.

{
  "name": "my-app",
  "version": "1.0.0",
  "private": true,
  "scripts": {
    "start": "expo start",
    "android": "expo start --android",
    "ios": "expo start --ios"
  },
  "dependencies": {
    "react": "^18.3.0",
    "react-native": "^0.76.0"
  },
  "devDependencies": {
    "typescript": "^5.5.0",
    "@types/react": "^18.3.0"
  }
}

npm en el desarrollo de React Native

Los proyectos de React Native utilizan activamente npm para la gestión de dependencias. El conjunto estándar incluye react, react-native, librerías de navegación (React Navigation), de peticiones HTTP (axios), de gestión de estado (Redux, Zustand) y componentes de UI. npm permite instalar miles de paquetes compatibles desde el registro.

npx pod-install — un comando obligatorio tras instalar módulos nativos en React Native para iOS. npm genera automáticamente un Podfile.lock basado en package-lock.json. En proyectos Expo se usa expo install en lugar de npm install, ya que selecciona versiones compatibles con la versión actual de Expo SDK.

Los conflictos de versiones son un problema común en React Native: react-native-reanimated, react-native-gesture-handler y react-native-safe-area-context requieren versiones alineadas. La solución es actualizar todos los paquetes a las últimas versiones compatibles o usar --legacy-peer-deps. package-lock.json es fundamental para los módulos nativos compilados mediante CocoaPods y Gradle.

Comparación de npm con gestores alternativos

npm es el gestor de paquetes estándar incluido con Node.js. Las principales alternativas: yarn (creado por Facebook en 2016) y pnpm (rápido, con enlaces duros). Desde npm 5, la diferencia en velocidad y funcionalidad entre npm y yarn es mínima. npm 7+ añadió workspaces, haciéndolo competitivo para monorepositorios.

Según State of JS 2025: el 62% de los desarrolladores usa npm, el 35% usa yarn (principalmente proyectos antiguos y entusiastas de PnP) y el 3% usa pnpm. Para proyectos React Native, ambas herramientas son igualmente viables, pero npm es más común en proyectos con Expo SDK 50+ y nuevas inicializaciones de React Native.

yarn conserva su ventaja en monorepositorios extremadamente grandes (100+ paquetes) gracias a su implementación más madura de workspaces y Plug'n'Play. pnpm gana en ahorro de espacio en disco mediante enlaces duros a un almacén global. La elección del gestor depende de las preferencias del equipo y la infraestructura.