guias
Ferramentas IA

Deploy com Cursor

Como fazer deploy de um app criado no Cursor direto na Veloz.

Você usou o Cursor para criar seu app. Agora vamos colocar no ar em 2 minutos.

O que você vai aprender

  • Preparar o projeto gerado pelo Cursor para produção
  • Fazer deploy na Veloz com um comando
  • Configurar variáveis de ambiente
  • Iterar: editar no Cursor → deploy → ver ao vivo

O fluxo

Cursor (Composer) → código pronto → veloz deploy → app no ar

1. Gerar o app no Cursor

Abra o Cursor e use o Composer (⌘I) para descrever o que quer:

Crie um app Next.js com uma landing page moderna, formulário de contato
que salva em um banco PostgreSQL, e uma página de admin para ver os
contatos. Use Tailwind CSS e Prisma.

O Cursor gera todos os arquivos. Aceite as mudanças e verifique se o app roda localmente:

npm install
npm run dev

2. Corrigir erros de build

Antes de deployar, rode o build localmente para garantir que funciona:

npm run build

Se der erro, cole o erro no Cursor Chat (⌘L):

Esse erro apareceu no build: [cole o erro aqui]
Corrija o código para resolver.

O Cursor corrige. Repita até o build passar.

3. Instalar a CLI da Veloz

No terminal do Cursor (⌃`):

npm install -g onveloz
veloz login

4. Deploy

No mesmo terminal:

veloz deploy
ℹ Framework detectado: Next.js
ℹ Build: npm run build
ℹ Start: npm start
ℹ Porta: 3000

? Confirmar e fazer deploy? (Y/n)

Confirme e aguarde:

✓ Build concluído em 32s
✓ Deploy concluído!
✓ https://meu-app.onveloz.com

Pronto. Seu app está no ar.

5. Variáveis de ambiente

Se o Cursor gerou código que usa variáveis de ambiente (.env), defina-as na Veloz:

# Veja quais variáveis o projeto usa
cat .env.example
 
# Defina na Veloz
veloz env set DATABASE_URL=postgres://...
veloz env set NEXT_PUBLIC_API_URL=https://meu-app.onveloz.com

O loop de iteração

Este é o fluxo que você vai usar constantemente:

  1. Editar no Cursor — Peça mudanças via Composer ou Chat
  2. Testar local — npm run dev para verificar
  3. Deploy — veloz deploy no terminal do Cursor
  4. Ver ao vivo — Abra a URL e confira
Cursor (editar) → dev (testar) → veloz deploy (publicar) → repetir

Com o tempo, você nem precisa testar local — confia no Cursor + Veloz e deploya direto.

Dicas para vibecoders

Peça ao Cursor para gerar o veloz.json

Gere um veloz.json para este projeto com as configurações corretas
de build, start e porta.

Peça ao Cursor para corrigir erros de deploy

Se o deploy falhar, copie o log de erro:

veloz logs --build

Cole no Cursor Chat:

O deploy na Veloz falhou com este erro: [cole aqui]
Corrija o código.

Use o Cursor para configurar domínio

Como configuro um domínio personalizado no meu provedor de DNS
para apontar para meu-app.onveloz.com?

Deploy automático

Para não precisar rodar veloz deploy manualmente a cada mudança:

  1. Faça push para o GitHub: git push
  2. Conecte o repo ao Veloz (veja CI/CD)
  3. Todo push dispara deploy automático

Projeto com banco de dados

Se o Cursor gerou um projeto com Prisma:

# Defina a URL do banco
veloz env set DATABASE_URL=postgres://user:pass@host:5432/db
 
# Rode as migrations (local, apontando pro banco de produção)
npx prisma migrate deploy
 
# Deploy
veloz deploy

Bancos recomendados para vibecoders:

  • Neon — PostgreSQL serverless, free tier generoso
  • Supabase — Postgres + Auth + Storage, dashboard visual
  • PlanetScale — MySQL, branching de schema

Próximos passos