turbopack

Configure Turbopack and migrate Next.js projects from webpack.

2|1|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/ByeongminLee/nextjs-claude-code --skill turbopack-byeongminlee
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: turbopack
Source: https://github.com/ByeongminLee/nextjs-claude-code/tree/main/template/skills-archive/turbopack
Command: npx skills add https://github.com/ByeongminLee/nextjs-claude-code --skill turbopack-byeongminlee

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Turbopack provides guidance for configuring the Next.js Turbopack bundler, diagnosing performance issues, and migrating from webpack to the modern Rust-powered pipeline, helping you accelerate development and fix build problems quickly.

Core Features & Use Cases

  • Migration guidance: Assist in moving Next.js projects from webpack to Turbopack and updating next.config.ts accordingly.
  • Performance optimization: Explain how to leverage Turbopack features like instant HMR, caching, and multi-environment builds to speed up iteration.
  • Debug & diagnostics: Provide steps to diagnose common build and dev-server issues, including webpack-like patterns and Turbopack-specific tips.

Quick Start

Use the turbopack skill to migrate a Next.js project from webpack to Turbopack and verify HMR behavior.

Frequently Asked Questions about turbopack

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate a Next.js project from webpack to Turbopack?

To migrate from webpack to Turbopack, you need to update your Next.js configuration file and verify your build pipeline compatibility. This guide provides steps to transition your project and adjust next.config settings for the Rust-powered bundler.

Why is my Turbopack HMR not working during Next.js development?

Turbopack HMR issues often stem from incorrect next.config.ts setup or conflicting webpack patterns. You can diagnose these development server problems by following specific Turbopack debugging steps to ensure instant HMR is functioning correctly.

Does Turbopack support custom CSS and loaders in Next.js 16?

Yes, Turbopack handles CSS and custom loaders in Next.js 16 projects. This guide explains how to properly configure your next.config file to ensure your styling and asset loading requirements are met during development and production builds.

What is the best way to optimize Turbopack performance for a Next.js bundler?

The best way to optimize Turbopack performance is by leveraging its caching mechanisms and multi-environment build capabilities. Configuring these features in your next.config file significantly speeds up development iteration and fixes build problems quickly.

When should I not use Turbopack instead of webpack for Next.js?

You should evaluate not using Turbopack if your Next.js project relies heavily on unsupported webpack-specific patterns. Diagnosing build issues is necessary to determine if your current loader configurations are compatible with the Turbopack pipeline.