Runbooks
Deploy Vercel (workaround --prebuilt)
Como fazer deploy das torres ZZYON quando o build remoto do Vercel falha
Sintoma
Após vercel deploy --prod, o deploy entra em estado ERROR instantaneamente, sem
build logs (buildingAt e ready no mesmo timestamp). O comando devolve:
{
"status": "error",
"reason": "deploy_failed",
"message": ""
}Não é problema do código — npm run build localmente roda limpo.
Causa provável
Next.js 16 + Turbopack flaky no builder hosted do Vercel para esta conta/projeto.
Confirmado em zyon-saude (descobrimos em 2026-05-02).
Workaround: deploy --prebuilt
Build localmente e suba só os artefatos prontos:
cd /caminho/para/zyon-saude
npx --yes vercel@latest build --prod
npx --yes vercel@latest deploy --prebuilt --prod --yesTempo total: ~30s para build + ~15s para upload.
Script de automação
Crie deploy.sh na raiz do projeto:
#!/bin/bash
set -e
echo "Building locally..."
npx --yes vercel@latest build --prod
echo "Deploying prebuilt..."
npx --yes vercel@latest deploy --prebuilt --prod --yeschmod +x deploy.sh e rode ./deploy.sh.
Quando voltar pro fluxo normal
Tentar vercel deploy --prod (sem --prebuilt) depois de:
- Vercel atualizar suporte a Next 16 stable
- Mudar
next.config.tsremovendo Turbopack - Conta upgrade de plano (se for limite de quota)
Troubleshooting
Se --prebuilt também falhar, checar:
vercel whoami— auth válida?.vercel/project.jsonaponta pro projectId certo?- Quota Vercel não estourou? Ver dashboard.
- Pasta
.vercel/output/foi gerada pelo build local?