Vercel Doctor

Configuração

Configure o Vercel Doctor com um arquivo de config para ignorar regras, arquivos e personalizar o comportamento.

O Vercel Doctor funciona sem configuração. Quando precisar personalizar o comportamento, você pode adicionar um arquivo de configuração.

Arquivo de configuração

Crie um vercel-doctor.config.json na raiz do projeto:

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

Alternativamente, adicione a chave "vercelDoctor" ao seu package.json:

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

Se ambos existirem, vercel-doctor.config.json tem precedência.

Opções

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

Ignorando regras

Use o formato plugin/rule para IDs de regras:

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

Veja as páginas de Rules para todos os IDs de regras disponíveis.

Ignorando arquivos

Use padrões glob para excluir arquivos da varredura:

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

Sobrescritas via CLI

Flags da CLI sempre têm precedência sobre os valores do arquivo de configuração. Por exemplo, --verbose na linha de comando sobrescreve "verbose": false no arquivo de configuração.

Exemplo completo

{
  "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