Plataforma

Essas regras detectam problemas de configuração em nível de plataforma e sugerem otimizações para deploys na Vercel.

vercel-edge-heavy-import

Detecta arquivos de runtime edge que importam dependências pesadas ou centradas em Node como node:fs, node:crypto, sharp ou @aws-sdk/*.

Por que importa: Funções edge têm limites rígidos de tamanho e execução. Dependências pesadas do Node.js aumentam o tempo de cold start e podem falhar em runtime.

Correção: Mova a lógica pesada para funções de runtime Node.js ou jobs em segundo plano, e mantenha os handlers edge leves.

vercel-sequential-database-await

Detecta rotas de API com 3 ou mais chamadas sequenciais ao Prisma ou banco de dados sem Promise.all.

Por que importa: Cada chamada sequencial ao banco adiciona latência à execução da função. Paralelizar queries independentes reduz duração total e custo.

const users = await prisma.user.findMany();
const posts = await prisma.post.findMany();
const tags = await prisma.tag.findMany();

const [users, posts, tags] = await Promise.all([
  prisma.user.findMany(),
  prisma.post.findMany(),
  prisma.tag.findMany(),
]);

vercel-large-static-asset

Detecta assets estáticos (imagens, fontes, vídeos, PDFs) de 4 KB ou mais servidos do repositório da sua aplicação.

Por que importa: Arquivos estáticos grandes servidos do seu deploy Vercel consomem largura de banda em toda requisição. Movê-los para um CDN dedicado ou armazenamento de objetos (Cloudflare R2, S3) reduz custos de largura de banda.

Reporta até 20 arquivos, ordenados por tamanho (maiores primeiro).

vercel-consider-bun-runtime

Detecta projetos não configurados para o runtime Bun (sem packageManager: "bun@..." no package.json e sem arquivo bun.lock).

Por que importa: O runtime Bun pode reduzir overhead de instalação e build na Vercel em comparação ao Node.js.

Correção: Revise a documentação do runtime Bun e mude se seu projeto for compatível.

vercel-avoid-platform-cron

Detecta crons configurados em vercel.json.

Por que importa: Jobs cron da Vercel rodam como funções serverless, cobrados por execução. Cargas programadas com padrões previsíveis costumam ser mais baratas usando GitHub Actions ou Cloudflare Workers Cron Triggers.

vercel-consider-fluid-compute

Detecta projetos com 3 ou mais rotas de API/servidor.

Por que importa: O Fluid Compute melhora a concorrência e reduz o overhead de execução para cargas com latência variável ou tráfego em rajadas. Vale a pena avaliar para projetos com múltiplas rotas de servidor.

vercel-suggest-turbopack-build-cache

Esta verificação é sensível à versão e só se aplica a projetos com Next.js 16+.

Detecta arquivos next.config com configurações experimental mas sem turbopackFileSystemCacheForBuild.

Por que importa: O Next.js 16+ suporta cache de build do Turbopack, que pode reduzir significativamente os tempos de build.

// next.config.js
module.exports = {
  experimental: {
    turbopackFileSystemCacheForBuild: true,
  },
};

vercel-suggest-deploy-archive

Detecta projetos com 5.000 ou mais arquivos.

Por que importa: Projetos grandes podem atingir limites de taxa da API durante o deploy. Usar o modo de arquivo faz upload de um único tarball em vez de arquivos individuais, reduzindo o tempo de deploy em cerca de 50%.

vercel deploy --archive=tgz