Nudeps de Lea Verou: cómo usar paquetes npm en el navegador sin bundler ni configuraciones extraArtículo · digest del 19 de noviembre
Nudeps de Lea Verou: cómo usar paquetes npm en el navegador sin bundler ni configuraciones extra
Artículo5 secciones≈ 9 min

Nudeps de Lea Verou: cómo usar paquetes npm en el navegador sin bundler ni configuraciones extra

Cruce de caminos conocido. Armar un sitio pequeño o una demo en HTML y JS puro, y de pronto quieres sumar Vue, D3 o una librería de tooltips. Normalmente quedan dos caminos, y ambos molestan: o descargas archivos a mano, enlazas CDNs externos y olvidas npm install, o instalas un bundler como Vite o Webpack. Todo por una sola línea: import { createApp } from "vue".

El navegador por sí solo no entiende eso. Escribir "vue" sin dirección ni ruta se llama bare specifier, una importación por nombre corto. El navegador necesita una URL real, y node_modules/ nunca se diseñó para subirse a un servidor. Por eso acabas metiendo un bundler incluso en el proyecto más simple. Con él llegan archivos de configuración, procesos en segundo plano y capas extra donde código válido para el navegador se rompe al compilar. En la encuesta State of JS 2025, gestionar dependencias quedó en tercer lugar entre los mayores dolores de cabeza de los desarrolladores JS, y las herramientas de build en sexto.

El 18 de noviembre de 2026, Lea Verou publicó en su blog el lanzamiento de Nudeps, una herramienta ligera bajo licencia MIT (v0.4.4, 133.8 KB). Armó el primer prototipo en febrero junto a su alumno Dmitry Sharabin, luego lo probó con betatesters y consultó a Jordan Harband. El nombre juega con dos ideas: nude deps («dependencias desnudas», sin envoltorio de bundler) y el sonido de new deps.

La propuesta es simple: no abolir los bundlers, sino crear una «compilación ligera» (light-build). Los empaquetadores hacen falta para compilación compleja y optimización pesada, mientras Nudeps resuelve las tareas simples sin tocar ni una línea de tu propio código.

Dos comandos en vez de configuraciones: cómo opera sin proceso en segundo plano

Tras instalarlo, puedes olvidarte de Nudeps. No se queda corriendo en segundo plano, no vigila cambios de archivos ni reescribe tu JS. En la carpeta con package.json basta un comando:

# Instala nudeps, añade los hooks y genera el mapa de importaciones al instante
npx nudeps install

Añade nudeps a devDependencies, hace la primera pasada y escribe dos scripts en package.json. Todo el truco descansa en el hook integrado dependencies de npm, que muchos ni conocen: se ejecuta solo después de cada npm install y npm uninstall. Y prepare actualiza el proyecto tras un git clone limpio.

{
  "scripts": {
    "dependencies": "npx nudeps",
    "prepare": "npx nudeps"
  },
  "devDependencies": {
    "nudeps": "^0.4.4"
  },
  "dependencies": {
    "jquery": "^4.0.0",
    "jquery1": "npm:jquery@^1.12.4"
  }
}

Este es el package.json real de la demo con jQuery, donde conviven dos versiones de la librería mediante un alias de npm. No hace falta tener ningún watcher en la terminal. La gente está tan acostumbrada a configuraciones largas que los primeros testers desconfiaban del silencio. Sam Littlefair contó que ejecutó npx, añadió el mapa de importaciones y se quedó esperando un montón de pasos extra, hasta descubrir sorprendido que ya estaba todo listo.

Un servidor HTTP local para módulos ES sigue siendo necesario (por file:// el navegador los bloquea). Pero, como bromea Lea, un servidor local no cuesta nada: lo levanta el editor o el agente, y ella mantiene un único servidor corriendo en la raíz de su carpeta de repositorios.

Qué hay por dentro: client_modules, JSPM y un importmap.js inteligente

Por dentro, Nudeps une piezas ya probadas. La primera son los Import Maps (mapas de importación), el diccionario nativo <script type="importmap"> del navegador que traduce "vue" a la ruta real del archivo. El estándar ya es Baseline Widely Available, así que funciona de forma estable en todos los navegadores principales.

La segunda es el motor JSPM (@jspm/generator y @jspm/overrides), que suele usarse con CDN pero aquí trabaja en local. Con cada npm install, Nudeps copia los archivos necesarios de node_modules/ a una carpeta plana client_modules/ con la versión en el nombre, como client_modules/vue@3.5.45/. Desaparecen los duplicados y la caché del navegador se invalida con precisión: si actualizas un paquete, los demás no se vuelven a descargar. Dentro de client_modules/ y .nudeps/ se genera su propio .gitignore para no ensuciar Git, pero client_modules/ sí se sube al despliegue.

Los navegadores aún exigen incluir <script type="importmap"> en el HTML de cada página. Nudeps esquiva eso con un script /importmap.js que inyecta la etiqueta al vuelo:

<!-- Script normal sin type="module", siempre antes de los módulos -->
<script src="/importmap.js"></script>
<script type="module">
  // El nombre corto funciona directo en el navegador
  import { createApp } from "vue";
</script>

En el importmap.js real de la demo de Vue se nota un detalle muy cuidado. El script recalcula las rutas relativas desde su propia ubicación mediante new URL(m[k], document.currentScript.src).href, así que un mismo archivo sirve en páginas a cualquier profundidad. Además lanza un error si le ponen type="module" de más y avisa en consola si se colocó después de un script modular. Y antes de producción, la opción prune recorta importaciones sin uso: en desarrollo el mapa conserva todos los puntos de entrada para no regenerarse con cada import nuevo en tu código.

Qué funciona ya: desde Vue y dos jQuery hasta CSS y lodash

El propio sitio nudeps.dev ya corre sobre nudeps@0.4.4. En ejemplos reales sin bundler arrancan Vue (la opción favorita de Lea), Lit, D3, gsap, Three.js, Floating UI, interact.js y Underscore, e incluso React, aunque escribirlo sin JSX resulta incómodo. Funcionan import() dinámico, import.meta.resolve(), paquetes locales (npm i ../foo), dependencias git, alias y workspaces experimentales.

Con los formatos de módulos el reparto es claro. Los paquetes ESM modernos (import/export) los entiende el navegador directo y todo va fluido. Para librerías CommonJS antiguas como lodash, pensadas para require() en Node.js, Nudeps ofrece una capa experimental cjs-browser-shim, donde importas import { require } from "cjs-browser-shim" y llamas a require("lodash").

Con librerías de CSS e iconos como Open Props o Bootstrap Icons cambia el asunto: los navegadores aún no importan hojas de estilo por nombre corto, hace falta una URL. Para no corregir enlaces tras cada actualización de paquete, Nudeps crea enlaces simbólicos (symlinks) sin versión en client_modules/ (o redirecciones donde el hosting no los soporte):

<!-- La ruta por enlace simbólico no se rompe al actualizar el paquete -->
<link
  rel="stylesheet"
  href="client_modules/open-props/open-props.min.css"
/>

Así están conectados los estilos en la demo de Open Props. Hay una única limitación: un paquete así no podrá traer dependencias CSS externas si no vienen empaquetadas dentro, aunque casi todas las librerías de estilos e iconos son autosuficientes.

Cómo Nudeps enfrentó a Claude con npm, y cómo ayudó SKILL.md

Con los agentes de IA surgió una anécdota curiosa. Desde las pruebas de febrero, Claude se manejaba bien con Nudeps, pero por costumbre hacía trabajo de más: añadía client_modules/ al .gitignore aunque la carpeta ya se autoignora, agregaba npm run build y ejecutaba npx nudeps a mano. También lanzaba npm run dependencies manualmente creyendo que era un script casero.

Lo más gracioso: Claude no conocía el hook integrado dependencies de npm y, según Lea, discutía convencido de que no existía. Todo se resolvió con el archivo SKILL.md en el repositorio de Nudeps, con una tabla de errores típicos de agentes (no tocar client_modules/, no poner type="module" en importmap.js, no correr npx nudeps a mano). Se instala en Claude Code, Cursor y Copilot con npx skills add nudeps/nudeps, y los cambios sobrantes desaparecen.

Dónde no alcanza Nudeps y conviene dejar el bundler

Nudeps respeta con honestidad sus límites. No compila nada de tu código: para TypeScript, JSX, Svelte y componentes de un archivo de Vue (.vue) sigues necesitando un compilador aparte (aunque Nudeps convive bien con generadores estáticos o el compilador de TS). Por ahora solo soporta npm; pnpm y yarn encabezan la lista de pendientes, pero en la 0.4.4 no están.

También existe un techo de la propia plataforma. Los mapas de importación todavía no funcionan en Web Workers: el issue whatwg/html#8173, abierto por Guy Bedford en agosto de 2022, sigue abierto. Además varios paquetes esperan APIs de Node.js como process.env: lo pequeño se cubre con un shim, pero en casos pesados conviene pasar el bundle para navegador del paquete mediante sobrescrituras en nudeps.js.

Por último, la velocidad de primera carga. Sin empaquetado, una librería formada por decenas de archivos ESM pequeños dispara una cadena de peticiones en el navegador. Aún no hay mediciones frente a Vite, esbuild o Webpack, y Lea advierte con sinceridad que, según la estructura de los paquetes, un bundler puede ser bastante más rápido… o a veces un poco más lento.

Quiero un análisis detalladoLos votos ayudan a elegir qué analizar a fondo. Este material tiene 0 votos.
Fuentes · 9