next-upgrade

The next-upgrade skill is an engineering automation tool designed to streamline the complex process of updating Next.js projects. Targeted at developers and maintainers managing Next.js codebases, this skill reduces the manual overhead required to handle breaking changes, dependency updates, and API shifts that occur between major framework versions. By integrating directly with official Vercel documentation, it ensures that your project remains secure, performant, and compliant with the latest framework standards.

• Automated dependency management by updating next, react, and react-dom to their latest compatible versions.

• Execution of official @next/codemod scripts to automatically refactor source code for breaking changes, such as the transition to async Request APIs in Next.js 15.

• Incremental upgrade path calculation, allowing for safe multi-version jumps (e.g., v13 to v15) by breaking the process into manageable, version-specific steps.

• Intelligent detection of current project state by parsing package.json to identify the existing version and core dependencies.

• Verification workflows including build checks (npm run build) and development server testing (npm run dev) to ensure the upgrade does not regress site functionality.

• The skill requires a clean working directory and version control (git) to easily roll back if an automated migration fails.

• It is highly recommended to review the output of codemods manually, as some complex codebase patterns may require human intervention or fine-tuning.

• The skill fetches real-time documentation from nextjs.org; ensure an internet connection is available to retrieve the latest migration guides.

• When performing major jumps, it is safer to run the upgrade incrementally rather than skipping versions to avoid compounding unhandled breaking changes.

• Use the skill as part of your regular maintenance cycle to avoid 'version debt' and ensure compatibility with modern React features and Next.js optimization patterns.