guias
Ferramentas IA

Deploy com Replit

Como exportar um app do Replit e fazer deploy na Veloz.

O Replit é um ambiente de desenvolvimento completo no navegador com IA integrada (Replit Agent). Veja como trazer seu projeto Replit para a Veloz.

O fluxo

Replit (criar com Agent) → download/GitHub → veloz deploy → app no ar

1. Criar o app no Replit

No Replit, use o Agent para gerar seu app:

Crie um app Next.js com autenticação via Google, dashboard de tarefas
com CRUD completo, e banco PostgreSQL. Use Tailwind CSS.

O Replit Agent cria o projeto, instala dependências e mostra o preview ao vivo.

2. Exportar o projeto

Opção A: Via GitHub (recomendado)

  1. No Replit, clique em Git no painel lateral
  2. Conecte seu GitHub e faça push para um repositório
  3. Clone localmente:
git clone https://github.com/seu-usuario/meu-app.git
cd meu-app

Opção B: Download direto

  1. No Replit, clique nos três pontos (⋯) no painel de arquivos
  2. Selecione Download as ZIP
  3. Extraia e entre na pasta:
unzip meu-app.zip
cd meu-app

3. Preparar para deploy

O Replit às vezes usa configurações específicas (.replit, replit.nix). Elas não são necessárias para a Veloz.

Verifique se o package.json tem os scripts corretos:

{
  "scripts": {
    "build": "next build",
    "start": "next start"
  }
}

Instale as dependências e teste o build:

npm install
npm run build

4. Deploy

npm install -g onveloz
veloz login
veloz deploy
ℹ Framework detectado: Next.js
ℹ Build: npm run build
ℹ Start: npm start

? Confirmar e fazer deploy? (Y/n)

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

5. Variáveis de ambiente

O Replit usa "Secrets" para variáveis de ambiente. Transfira para a Veloz:

  1. No Replit, vá em Secrets e copie os valores
  2. Defina na Veloz:
veloz env set DATABASE_URL=postgres://...
veloz env set GOOGLE_CLIENT_ID=...
veloz env set GOOGLE_CLIENT_SECRET=...

Banco de dados

Se o Replit Agent criou um banco PostgreSQL integrado, você precisa migrar para um banco externo:

Neon (recomendado)

  1. Crie um banco no Neon
  2. Copie a connection string
  3. Defina na Veloz:
veloz env set DATABASE_URL=postgres://user:pass@ep-xxx.us-east-2.aws.neon.tech/mydb
  1. Rode as migrations:
npx prisma migrate deploy

Supabase

  1. Crie um projeto no Supabase
  2. Vá em Settings → Database → Connection string
  3. Defina na Veloz:
veloz env set DATABASE_URL=postgres://postgres:pass@db.xxxx.supabase.co:5432/postgres

Por que Veloz ao invés do Replit Deploy?

  • Servidores no Brasil — Latência 10x menor para usuários brasileiros
  • Sem cold starts — App sempre ativo, sem esperar spin-up
  • Domínio personalizado — Seu .com.br com SSL automático
  • Scaling — Múltiplas instâncias, autoscale configurável
  • Preço previsível — Sem cobrança por ciclos de computação

Deploy automático

Se você exportou para GitHub:

  1. Conecte o repo à Veloz via GitHub App
  2. Continue editando no Replit
  3. Cada push → deploy automático na Veloz
Replit (editar) → GitHub (push) → Veloz (deploy automático)

Próximos passos