Qu'est-ce que Vercel Doctor ?
Réduisez votre facture Vercel en analysant votre codebase Next.js pour détecter les motifs coûteux.
Vercel Doctor est un outil de diagnostic de santé pour les projets Next.js déployés sur Vercel. Il analyse votre codebase à la recherche de motifs qui font augmenter la facture — durée des fonctions, routes non mises en cache, images non optimisées, etc. — puis attribue un score sur 100 avec des corrections actionnables. Les recommandations s'adaptent à la version majeure de Next.js détectée.
Démarrage rapide
Exécuter sur votre projet
npx -y vercel-doctor@latest .C'est tout. Pas d'installation, pas de config. Il analyse la codebase et affiche un score avec des diagnostics.
Corriger les problèmes
Chaque diagnostic inclut un message d'aide expliquant quoi modifier et pourquoi. Corrigez d'abord les règles à fort impact — les erreurs avant les avertissements.
Réexécuter pour vérifier
npx -y vercel-doctor@latest . --diffUtilisez --diff sur les branches de fonctionnalité pour n'analyser que les fichiers modifiés.
Ce qu'il vérifie
Vercel Doctor exécute deux passes d'analyse en parallèle :
- Billing lint — règles basées sur l'AST et des motifs qui détectent les patterns Next.js et Vercel coûteux
- Détection de dead code — repère les fichiers, exports et types inutilisés qui alourdissent le bundle et ralentissent les cold starts
Catégories de règles
| Category | Rules | What it catches |
|---|---|---|
| Function Duration | 3 | Sequential awaits, blocking logging, non-parallel I/O |
| Caching | 6 | force-dynamic, missing cache policies, no-store fetches, side effects in GET handlers |
| Invocations | 2 | Client-side fetching in pages, aggressive link prefetching |
| Image Optimization | 4 | Global unoptimized, missing sizes, broad remote patterns, SVG without unoptimized |
| Platform | 8 | Edge heavy imports, cron jobs, Bun runtime, Fluid Compute, deploy archive, Turbopack cache |
| Dead Code | 4 | Unused files, exports, types, and duplicates |
Fonctionnalités
- Zéro config — fonctionne immédiatement sur tout projet Next.js
- Support monorepo — détecte automatiquement les workspaces, permet de choisir les projets à analyser
- Mode diff — analyse uniquement les fichiers modifiés sur les branches de fonctionnalité
- Scoring — score de 0 à 100 avec les labels Great / Needs work / Critical
- Compatible CI — mode non interactif pour les pipelines automatisés
- Configurable — ignorer des règles ou fichiers via un fichier de config
- AI skill — installation en tant que skill pour Claude Code, Cursor, Codex et plus
- Recommandations selon la version — les recommandations s'adaptent à la version majeure de Next.js détectée
Last updated on