claudegoodies
Skill

nextjs-turbopack

From affaan-m

Next.js 16+ y Turbopack — bundling incremental, caché en sistema de archivos, velocidad de desarrollo y cuándo usar Turbopack frente a webpack.

Explains Next.js 16+ Turbopack defaults, filesystem caching, webpack fallback, and the proxy.ts middleware rename.

Use it when

  • Debugging slow next dev startup or HMR in Next.js 16+ apps
  • Deciding whether to fall back to webpack for a plugin bug
  • Checking if proxy.ts is correctly replacing middleware.ts
  • Investigating production bundle size with Bundle Analyzer

Skip it if

  • Only applies to Next.js 16+; irrelevant for older versions or other frameworks
  • Reference/explanation document, not a tool that runs commands for you
  • Defers to official Next.js docs for version-specific config details

Facts

Repository
affaan-m/ECC
Status
Actively maintained
Last commit
Source file
.agents/skills/nextjs-turbopack/SKILL.md

Source preview

The instructions Claude Code reads when this skill runs.

# Next.js y Turbopack

Next.js 16+ usa Turbopack por defecto para el desarrollo local: un bundler incremental escrito en Rust que acelera significativamente el inicio del servidor de desarrollo y las actualizaciones en caliente.

## Cuándo Usar

- **Turbopack (desarrollo por defecto)**: Usar para el desarrollo diario. Inicio en frío y HMR más rápidos, especialmente en apps grandes.
- **Webpack (desarrollo heredado)**: Usar solo si encuentras un bug de Turbopack o dependes de un plugin exclusivo de webpack en desarrollo. Desactivar con `--webpack` (o `--no-turbopack` según la versión de Next.js; consultar la documentación de tu versión).
- **Producción**: El comportamiento del build de producción (`next build`) puede usar Turbopack o webpack según la versión de Next.js; consultar la documentación oficial de Next.js para tu versión.

Usar cuando: se desarrollen o depuren apps Next.js 16+, se diagnostique un inicio de desarrollo lento o HMR, o se optimicen bundles de producción.

## Cómo Funciona

- **Turbopack**: Bundler incremental para el desarrollo de Next.js. Usa caché en sistema de archivos para que los reinicios sean mucho más rápidos (ej. 5-14x en proyectos grandes).
- **Por defecto en desarrollo**: Desde Next.js 16, `next dev` se ejecuta con Turbopack a menos que se deshabilite.
- **Caché en sistema de archivos**: Los reinicios reutilizan el trabajo anterior; la caché est
View full source on GitHub →

Other skills