Deploy da Documentação na Vercel

URL

Production: https://docs.radimenstein.com

Configuração

Configuração Inicial

1. Acesse Vercel Dashboard
2. Clique em "Add New Project"
3. Importe o repositório trevo-rad-dimenstein-v2/trevo-docs
4. Configure as seguintes opções:

Configurações do Projeto

• Framework Preset: Other
• Root Directory: . (raiz do projeto)
• Build Command: pnpm docs:build
• Output Directory: docs/.vitepress/dist
• Install Command: pnpm install
• Node Version: 20

Arquivo vercel.json

O arquivo vercel.json já está configurado com essas opções:

{
  "buildCommand": "pnpm docs:build",
  "outputDirectory": "docs/.vitepress/dist",
  "devCommand": "pnpm docs:dev",
  "installCommand": "pnpm install",
  "framework": null
}

Domínio Customizado

Configurar docs.radimenstein.com

1. No projeto Vercel, vá em Settings → Domains
2. Adicione o domínio: docs.radimenstein.com
3. Configure os registros DNS conforme instruções da Vercel:
   • Tipo: CNAME
   • Nome: docs
   • Valor: cname.vercel-dns.com

SSL

A Vercel configura SSL automaticamente após a configuração do DNS.

Deploy Automático

• Deploy automático em push para main
• Preview deployments em Pull Requests
• Builds são executados automaticamente

Variáveis de Ambiente

Não são necessárias variáveis de ambiente para a documentação estática.

Build Local

Para testar o build localmente:

pnpm install
pnpm docs:build
pnpm docs:preview

Troubleshooting

Build Falha

• Verifique se o Node.js version está configurado como 20
• Confirme que pnpm está disponível (Vercel instala automaticamente)
• Verifique os logs de build na Vercel Dashboard

Domínio Não Funciona

• Verifique se os registros DNS estão configurados corretamente
• Aguarde propagação DNS (pode levar até 48 horas)
• Verifique SSL na Vercel Dashboard

Assets Não Carregam

• Confirme que o base está configurado como / no .vitepress/config.ts
• Verifique se os arquivos em docs/public/ estão sendo incluídos no build