guias
Ferramentas IA

Deploy com Bolt

Como fazer deploy de um app criado no Bolt.new na Veloz.

O Bolt.new gera apps completos no navegador. Veja como levar seu projeto Bolt para a Veloz.

O que você vai aprender

  • Exportar um projeto do Bolt
  • Fazer deploy na Veloz
  • Configurar variáveis de ambiente e domínio

O fluxo

Bolt.new (criar) → download → veloz deploy → app no ar

1. Criar o app no Bolt

Acesse bolt.new e descreva o que quer:

Crie uma landing page com formulário de waitlist, animações suaves,
design moderno escuro com detalhes em laranja. Use React + Vite.

O Bolt gera o app completo com preview ao vivo.

2. Baixar o projeto

No Bolt, clique em Download para baixar o projeto como ZIP.

Extraia o ZIP:

unzip meu-projeto.zip
cd meu-projeto

3. Instalar dependências

npm install

Verifique se roda localmente:

npm run dev

4. Deploy

npm install -g onveloz
veloz login
veloz deploy

A Veloz detecta o framework (Vite, Next.js, etc.) automaticamente:

ℹ Framework detectado: Vite + React
ℹ Build: npm run build
ℹ Output: dist

? Confirmar e fazer deploy? (Y/n)

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

5. Iterar

Quer fazer mudanças? Duas opções:

Opção A: Voltar ao Bolt

Faça as edições no Bolt, baixe novamente e re-deploy:

veloz deploy

Opção B: Editar localmente

Abra o projeto no Cursor ou VS Code, edite e deploy:

# Editar → salvar → deploy
veloz deploy

Frameworks comuns do Bolt

O Bolt gera projetos com diferentes stacks. A Veloz suporta todos:

Stack gerada Tipo na Veloz
Vite + React Site Estático
Vite + Vue Site Estático
Next.js Serviço Web
Astro Site Estático
Express + React Serviço Web

Variáveis de ambiente

Se o Bolt gerou código que usa APIs externas:

veloz env set VITE_SUPABASE_URL=https://...
veloz env set VITE_SUPABASE_ANON_KEY=eyJ...

Lembre: variáveis com prefixo VITE_ são injetadas no build. Faça deploy após definí-las.

Domínio personalizado

veloz domains add meuapp.com.br

Dica: Git

O Bolt não cria um repositório Git. Para versionamento e deploy automático:

git init
git add .
git commit -m "initial commit from bolt"
gh repo create meu-projeto --push --source=.

Depois conecte ao Veloz para deploy automático a cada push.

Próximos passos