Vercel Doctor

Configuration

Configurez Vercel Doctor avec un fichier de config pour ignorer des règles, des fichiers et personnaliser le comportement.

Vercel Doctor fonctionne sans configuration. Lorsque vous devez personnaliser le comportement, vous pouvez ajouter un fichier de config.

Fichier de config

Créez un vercel-doctor.config.json à la racine du projet :

{
  "ignore": {
    "rules": ["vercel-doctor/nextjs-link-prefetch-default"],
    "files": ["src/generated/**"]
  }
}

Ou ajoutez une clé "vercelDoctor" à votre package.json :

{
  "vercelDoctor": {
    "ignore": {
      "rules": ["knip/exports"],
      "files": ["src/generated/**"]
    }
  }
}

Si les deux existent, vercel-doctor.config.json prend la priorité.

Options

KeyTypeDefaultDescription
ignore.rulesstring[][]Rule IDs to suppress, in plugin/rule format
ignore.filesstring[][]Glob patterns for file paths to skip
lintbooleantrueEnable or disable billing lint rules
deadCodebooleantrueEnable or disable dead code detection
verbosebooleanfalseShow file paths and line numbers per rule
diffboolean | stringfalseEnable diff mode or pin a base branch

Ignorer des règles

Utilisez le format plugin/rule pour les IDs de règles :

{
  "ignore": {
    "rules": [
      "vercel-doctor/nextjs-image-missing-sizes",
      "vercel-doctor/vercel-large-static-asset",
      "knip/exports"
    ]
  }
}

Voir les pages Rules pour tous les IDs de règles disponibles.

Ignorer des fichiers

Utilisez des patterns glob pour exclure des fichiers de l'analyse :

{
  "ignore": {
    "files": ["src/generated/**", "**/*.stories.tsx", "scripts/**"]
  }
}

Surcharges CLI

Les drapeaux CLI prennent toujours la priorité sur les valeurs du fichier de config. Par exemple, --verbose en ligne de commande écrase "verbose": false dans le fichier de config.

Exemple complet

{
  "ignore": {
    "rules": [
      "vercel-doctor/vercel-consider-bun-runtime",
      "vercel-doctor/vercel-avoid-platform-cron"
    ],
    "files": ["src/generated/**", "e2e/**"]
  },
  "lint": true,
  "deadCode": true,
  "verbose": false,
  "diff": "main"
}
Edit on GitHub

Last updated on

On this page