next-upgrade

Automate Next.js version migrations with official codemods and dependency updates.

51|6|Updated Mar 28, 2019
One-click install
npx skills add https://github.com/Mte90/dotfiles --skill next-upgrade-mte90
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: next-upgrade
Source: https://github.com/Mte90/dotfiles/tree/main/.config/opencode/skills/nextjs/upgrade
Command: npx skills add https://github.com/Mte90/dotfiles --skill next-upgrade-mte90

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the complex process of upgrading Next.js applications to newer versions, handling breaking changes and dependency updates efficiently.

Core Features & Use Cases

  • Automated Codemods: Applies official codemods to refactor code for new Next.js APIs.
  • Dependency Management: Updates Next.js and related peer dependencies to compatible versions.
  • Manual Verification Guidance: Provides clear steps to verify critical areas like async context and metadata after automated changes.
  • Use Case: Migrating a Next.js project from v14 to v15, ensuring all new features are adopted and breaking changes are resolved with minimal manual intervention.

Quick Start

Run the next-upgrade skill to migrate the current Next.js project to the latest version.

Frequently Asked Questions about next-upgrade

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

FAQPage Schema
How do I upgrade Next.js to a newer version without breaking changes?

Upgrading Next.js is automated by applying official codemods to refactor code for new APIs and updating peer dependencies to compatible versions seamlessly.

Can I migrate my Next.js project incrementally instead of jumping to the latest release?

Yes, Next.js migration supports incremental upgrades by applying codemods sequentially across versions, ensuring breaking syntax changes are handled progressively.

What are the manual verification steps required after running a Next.js codemod migration?

After Next.js codemod migration, manually verify critical areas like async context and metadata to ensure breaking syntax changes were applied correctly.

Does this Next.js migration tool work with both npm and yarn package managers?

Yes, Next.js version migration handles dependency updates and applies codemods for projects using either npm or yarn for package management.

How do official codemods handle breaking syntax changes during a Next.js version upgrade?

Official codemods automatically refactor existing Next.js code to match new API requirements during version upgrades, minimizing manual intervention for breaking syntax changes.

What is the best way to update peer dependencies when upgrading a Next.js application?

The best way to update Next.js peer dependencies is through an automated migration process that identifies and elevates related packages to compatible versions alongside the core framework.