next-upgrade

Aperçu

Qu'est-ce que next-upgrade ?

next-upgrade est une compétence spécialisée conçue pour aider les développeurs frontend à mettre à jour leurs projets Next.js vers la dernière version en toute simplicité. En automatisant le processus avec les guides de migration officiels et les codemods, next-upgrade réduit les efforts manuels et minimise les erreurs lors des transitions majeures de version.

À qui s'adresse next-upgrade ?

Cette compétence est idéale pour les développeurs React et Next.js qui maintiennent des applications en production et souhaitent bénéficier des dernières fonctionnalités, correctifs de sécurité et améliorations de performance de Next.js. Elle est particulièrement utile pour les équipes gérant des bases de code complexes ou devant suivre les meilleures pratiques pour les mises à jour du framework.

Problèmes résolus par next-upgrade

• Automatisation de la détection de la version actuelle de Next.js et des dépendances
• Récupération et application des guides de migration officiels les plus récents
• Exécution des codemods recommandés pour gérer les changements incompatibles
• Accompagnement dans les mises à jour incrémentales lors des sauts de versions majeures
• Garantie de la mise à jour simultanée des dépendances associées comme React et React DOM

Comment utiliser

Étapes d'installation

1. Ajoutez la compétence à votre agent :

   npx skills add https://github.com/vercel-labs/next-skills --skill next-upgrade
   

2. Préparez votre projet :
   • Assurez-vous que votre projet utilise Next.js et contient un fichier package.json.
   • Effectuez un commit ou une sauvegarde de votre code avant de commencer la mise à niveau.

Exécution de next-upgrade

1. Commencez par la documentation de la compétence :
   • Ouvrez SKILL.md pour un aperçu détaillé et des indications sur les arguments.
2. Détectez votre version actuelle :
   • La compétence lit votre package.json pour identifier les versions actuelles de Next.js et des dépendances associées.
3. Récupérez et examinez les guides de migration :
   • next-upgrade récupère la documentation officielle la plus récente depuis nextjs.org, incluant codemods et guides spécifiques aux versions.
4. Appliquez les codemods :
   • Utilisez les codemods recommandés pour votre parcours de mise à niveau. Par exemple :

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

   • Les transformations courantes incluent next-async-request-api, next-request-geo-ip et next-dynamic-access-named-export.
5. Mettez à jour les dépendances :
   • Mettez à jour Next.js et ses dépendances associées simultanément :

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

6. Vérifiez et testez :
   • Suivez le guide de migration pour les étapes manuelles et les changements incompatibles.
   • Testez soigneusement votre application après chaque étape de mise à jour.

Fichiers suggérés à consulter

• SKILL.md – Guide principal d'utilisation
• README.md, AGENTS.md et metadata.json – Contexte supplémentaire et configuration

FAQ

Que fait next-upgrade automatiquement ?

next-upgrade automatise la détection de version, la récupération des guides de migration officiels et l'exécution des codemods pour les mises à jour Next.js. Il simplifie le processus mais nécessite toujours une revue et des tests par le développeur.

Puis-je utiliser next-upgrade pour n'importe quelle version de Next.js ?

Oui, next-upgrade prend en charge les mises à jour incrémentales depuis les versions plus anciennes en suivant les guides officiels pour chaque version majeure. Pour les sauts importants, il recommande de procéder une version majeure à la fois.

next-upgrade met-il à jour React et React DOM ?

Oui, la compétence veille à ce que les dépendances associées comme React et React DOM soient mises à jour en même temps que Next.js pour garantir la compatibilité.

Où puis-je trouver plus de détails ou résoudre des problèmes ?

Consultez l'arborescence complète des fichiers dans l'onglet Files, incluant les références imbriquées et les scripts d'aide. Pensez toujours à vérifier la documentation officielle de migration Next.js pour les conseils les plus récents.