Next Upgrade

vercel/vercel-plugin/skills/next-upgrade/upstream

by vercel882e66c2698689324c341b7bb8fd8beb92c27bf6No license301 starsListed Oct 9, 2026Updated Oct 9, 2026Repository updated today

Upgrade Next.js to the latest version following official migration guides and codemods

Instructions onlySoftware Development
AI-generated overview

Guides upgrading a Next.js project to the latest version using official migration guides and codemods.

What it does
Walks an agent through upgrading a Next.js project: detecting the current version from package.json, fetching official upgrade guides, determining an incremental upgrade path, running Next.js codemods, updating Next.js and peer dependencies, reviewing breaking changes, updating TypeScript types, and testing the build. It produces an upgraded project plus a sequence of migration steps and commands.
When to use it
Use when a Next.js application needs to move to a newer major or minor version and the migration should follow official guides and codemods. Also useful for planning incremental version jumps and checking breaking changes before upgrading.
Requirements
Needs network access to fetch Next.js upgrade documentation, a Node.js project with npm and npx available, and the project's package.json. No scripts ship with the skill; it is instructions only.

Upgrade Next.js

Upgrade the current project to the latest Next.js version following official migration guides.

Instructions

  1. Detect current version: Read package.json to identify the current Next.js version and related dependencies (React, React DOM, etc.)

  2. Fetch the latest upgrade guide: Use WebFetch to get the official upgrade documentation:

  3. Determine upgrade path: Based on current version, identify which migration steps apply. For major version jumps, upgrade incrementally (e.g., 13 → 14 → 15).

  4. Run codemods first: Next.js provides codemods to automate breaking changes:

    bash
    npx @next/codemod@latest <transform> <path>

    Common transforms:

    • next-async-request-api - Updates async Request APIs (v15)
    • next-request-geo-ip - Migrates geo/ip properties (v15)
    • next-dynamic-access-named-export - Transforms dynamic imports (v15)

  5. Update dependencies: Upgrade Next.js and peer dependencies together:

    bash
    npm install next@latest react@latest react-dom@latest

  6. Review breaking changes: Check the upgrade guide for manual changes needed:

    • API changes (e.g., async params in v15)
    • Configuration changes in next.config.js
    • Deprecated features being removed

  7. Update TypeScript types (if applicable):

    bash
    npm install @types/react@latest @types/react-dom@latest

  8. Test the upgrade:

    • Run npm run build to check for build errors
    • Run npm run dev and test key functionality

Source and attribution

Source:vercel/vercel-plugininskills/next-upgrade/upstreamat commit882e66c

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

More from vercel/vercel-plugin

Next Cache Components

vercel

Reference guide for Next.js 16 Cache Components: PPR, the use cache directive, cacheLife, cacheTag and migration.

Software Development301updated today

Eve

vercel

Build durable backend AI agents with the eve framework. Use when creating, editing, or debugging an eve project — agent instructions, skills, tools, connections, channels, sandboxes, subagents, schedules, or evals.

Awaiting classification301updated today

Chat Sdk

vercel

Guides developers in building multi-platform chat bots with the Chat SDK TypeScript package.

Software Development301updated today

Ai Sdk

vercel

Guides developers in using the Vercel AI SDK, verifying APIs against version-matched bundled docs rather than memory.

Software Development301updated today

Vercel React Best Practices

vercel

Vercel's React and Next.js performance guidelines, with 64 prioritized rules for writing, reviewing and refactoring code.

Software Development301updated today

React Best Practices

vercel

A React and Next.js best-practices checklist of 64 rules for reviewing and optimizing TSX components.

Software Development301updated today

More in Software Development

Playground

anthropics

Featured

Builds self-contained interactive HTML playgrounds with controls, live preview, and copyable prompt output.

Software Development37Kupdated today

M5 Onboard

anthropics

Featured

Provisions M5Stack ESP32 boards by detecting them on USB, flashing UIFlow 2.0 firmware, and installing a MicroPython app bundle.

Software Development37Kupdated today

Cardputer Buddy

anthropics

Featured

Guides iterating on a Cardputer-Adv MicroPython app bundle: adding apps, pushing files over USB-serial, tailing logs, and running REPL commands.

Software Development37Kupdated today

Web Design Guidelines

vercel-labs

Featured

Reviews UI code against Web Interface Guidelines fetched from a remote source and reports findings as file:line entries.

Software Development32Kupdated 5 weeks ago

Vercel React Native Skills

vercel-labs

Featured

React Native and Expo best-practice rules covering list performance, animation, navigation, UI patterns, state, and monorepo setup.

Software Development32Kupdated 5 weeks ago

Vercel React Best Practices

vercel-labs

Featured

Vercel's React and Next.js performance guidelines, organized as 70 rules for writing, reviewing, and refactoring code.

Software Development32Kupdated 5 weeks ago
Next Upgrade · skills/next-upgrade/upstream Agent Skill | SourceWeft