view --main next-upgrade-avtomatizatsiya-obnovleniya-proektov-next-js.md

next-upgrade — Автоматизация обновления проектов Next.js

Name: next-upgrade — Автоматизация обновления проектов Next.js
Author: vercel-labs/next-skills

Next-Upgrade – это open-source решение, разработанное для автоматизации обновления проектов на базе Next.js. Инструмент существенно упрощает процесс миграции, избавляя от рутинной работы по поиску и применению инструкций, особенно при переходе между основными версиями. Он автоматизирует получение актуальных руководств по обновлению и запуск необходимых codemod преобразований.

Next-Upgrade предоставляет инструмент разработчика для управления зависимостями и версиями, что позволяет избежать конфликтов и обеспечить плавный переход к новой версии Next.js. Поддерживаются автоматизированная загрузка документации по миграции, исполнение codemod и управление версиями зависимостей, что значительно сокращает время и усилия, необходимые для обновления.

Благодаря автоматизации процесса обновления, Next-Upgrade снижает риск ошибок и повышает эффективность работы команды. Инструмент написан на Node.js с использованием JavaScript, npm и WebFetch и предназначен для упрощения DevOps задач, связанных с поддержкой актуальных версий Next.js проектов.

$ git log --oneline --stat

⭐ звёзды: 0

форки: 51

⬇️ установки: 95

обновлено: 16 февраля 2026 года в 18:06

Проводник файлов

1 файлы

SKILL.md

readonly --- lines

--- name: next-upgrade description: Upgrade Next.js to the latest version following official migration guides and codemods argument-hint: "[target-version]" --- # 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: - Codemods: https://nextjs.org/docs/app/guides/upgrading/codemods - Version-specific guides (adjust version as needed): - https://nextjs.org/docs/app/guides/upgrading/version-16 - https://nextjs.org/docs/app/guides/upgrading/version-15 - https://nextjs.org/docs/app/guides/upgrading/version-14 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

Инициализация мануала...