Zeltro › Como rodar um projeto do Bolt.new localmente
Rodando um projeto do Bolt.new no seu próprio computador
Dá para rodar o Bolt.new localmente? O criador não, o seu projeto sim. Como baixar um projeto do Bolt ou puxá-lo do GitHub, rodá-lo no seu próprio computador, lidar com o banco de dados do Bolt e continuar editando com a sua própria IA.
"Rodar o Bolt.new localmente" pode querer dizer duas coisas, e as respostas são diferentes.
O Bolt.new em si, o criador, não se instala. Ele roda no seu navegador, nos servidores do Bolt, com a IA e os tokens do Bolt. O irmão de código aberto dele, o bolt.diy, pode rodar no seu computador com as suas próprias chaves de API, mas é um projeto separado, sem contas em comum, e a última versão dele saiu em maio de 2025.
O seu projeto do Bolt roda localmente, sim. A própria documentação do Bolt mostra
como: baixe, instale o Node.js, npm install && npm run dev. Esta página trata disso, e
do que vem depois: manter o projeto rodando e seguir em frente quando você para de
construí-lo dentro do Bolt.
O que é um projeto do Bolt#
O Bolt cria apps em JavaScript, na maioria das vezes React com Vite, e os backends dele são só em JavaScript. Aqui isso é uma boa notícia: um projeto em JavaScript é o tipo mais fácil de rodar em qualquer lugar.
| Parte | Onde fica | Vem no download? |
|---|---|---|
| Seu código | No Bolt, e no GitHub se você conectou | Sim |
| Banco de dados | No Bolt Cloud (construído sobre o Supabase), se o projeto tiver um | Não |
| Segredos e variáveis de ambiente | No Bolt | Não conte com isso; confira o seu .env |
| Hospedagem | No Bolt Cloud | Não |
Passo 1: tire o código do Bolt#
Há dois jeitos, e o segundo é melhor se você pretende continuar.
Baixe um zip. Abra o projeto, clique no título dele no canto superior esquerdo, depois em Export → Download, e descompacte. Nas palavras do Bolt: "Você pode baixar seu projeto como um arquivo zip para trabalhar nele fora do Bolt, usando o seu próprio editor de código."
Conecte o GitHub. Clique no ícone do GitHub no Bolt, faça login, instale o GitHub App
do Bolt e crie um repositório para o projeto. Ele começa como um repositório privado no
main. A partir daí, o Bolt faz os commits por você: "Toda vez que você faz uma
alteração que não quebra o projeto, o Bolt cria um commit para você." Ele também
"verifica o GitHub a cada 30 segundos em busca de alterações feitas fora do Bolt e as
puxa", então o trabalho local e o Bolt podem conviver. Faça o seu trabalho local em um
branch: se os dois lados mudarem ao mesmo tempo, "o Bolt mantém as suas alterações e
sobrescreve a versão do GitHub".
Passo 2: rode, do jeito rápido#
Para uma primeira olhada, isto é tudo o que você precisa:
- Instale o Node.js.
- Abra um terminal na pasta do projeto.
- Rode
npm install && npm run dev.
O front end sobe na porta que o servidor de desenvolvimento dele mostrar. Se o app tem um banco de dados do Bolt, ele continua apontando para o Bolt Cloud, ou nem está conectado.
Passo 2, do jeito que dá para continuar usando#
O jeito rápido serve uma vez. Fica cansativo quando há três projetos desses, cada um na sua porta, cada um com a sua versão do Node, e nenhum com um banco de dados próprio.
O Zeltro é uma plataforma de desenvolvimento local gratuita feita exatamente para isso. Cada projeto roda no próprio contêiner, todos os projetos compartilham um único MariaDB, Postgres, MongoDB e Redis, e o seu agente de IA trabalha dentro do projeto. Para trazer um projeto do Bolt pelo GitHub:
zeltro clone work-directly https://github.com/you/your-bolt-app
Se for um zip, descompacte na sua pasta de projetos (~/zeltro-projects por padrão) e
adote o projeto:
zeltro setup your-bolt-app
De qualquer forma, o Zeltro lê o package.json, descobre o framework (React, Vue,
Next.js, Nuxt, SvelteKit, Astro, Express e mais) e configura o projeto no Node 22. Com um
agente de IA configurado, o clone também pede a ele que adapte o repositório ao Zeltro.
Depois:
zeltro status your-bolt-app
mostra o endereço do projeto neste computador e um endereço na rede local para o seu celular. Nada para decorar, nenhuma porta para escolher, e o próximo projeto do Bolt que você trouxer ganha o seu próprio endereço.
Dentro do Zeltro, o servidor de desenvolvimento de um app Node escuta na porta 3000, e o
navegador chega até ele pelo nginx na porta 80. Um projeto Vite que usa a 5173 por padrão
precisa de --port 3000 no script de desenvolvimento e, para o hot reload, de
server.ws.clientPort: 80 (server.hmr.clientPort antes do Vite 8.1) no vite.config.
Se a página ou o hot reload não subirem, quase sempre é por isso, e o seu agente consegue
corrigir.
Passo 3: o banco de dados do Bolt#
Se o projeto usa um banco de dados do Bolt, decida onde os dados dele devem ficar:
Deixe no Bolt Cloud
Por enquanto, enquanto você trabalha no front end. Lembre que, assim, as alterações locais mexem em dados reais.
Reivindique para o Supabase
O Bolt pode passar o banco de dados para a sua própria conta do Supabase pela aba Advanced do ícone Database. A documentação do Bolt diz que "reivindicar exige um plano Pro ou Teams". Depois, aponte o .env do app para o seu projeto.
Leve para um banco de dados local
O Zeltro já roda Postgres, MariaDB e MongoDB para todos os projetos. Tire os dados de lá e peça ao seu agente de IA que os carregue e reescreva a camada de dados para usá-los, passo a passo, com um banco de dados no seu próprio computador.
Não conecte um banco de dados novo do Supabase por cima de um banco de dados do Bolt que já existe para "mudá-lo": o Bolt avisa que substituir a conexão "pode causar perda de dados".
Passo 4: continue editando, sem tokens do Bolt#
Quando o projeto roda localmente, a IA que o edita pode ser a sua. O Zeltro não tem IA própria nem tokens para vender. Ele roda o agente que você escolher (Claude Code, Codex, Antigravity, Qwen Code, Aider, OpenCode ou Hermes) com uma assinatura que você já tem, uma chave de API pelo preço do próprio fornecedor, ou um modelo local gratuito.
cd ~/zeltro-projects/your-bolt-app
zeltro ai "read AGENTS.md, then add a contact form that saves to the database"
Todo projeto tem um AGENTS.md que descreve o endereço, o banco de dados e os comandos
dele, então o agente já começa situado. Veja
traga sua própria chave, ou teste os seus próprios números na
calculadora de economia.
Isso também significa que você não fica mais limitado ao JavaScript. Se o app pede um backend em Laravel, Django ou FastAPI, construa na pasta ao lado, e os dois projetos se encontram pelo nome na rede do Zeltro.
Fontes#
Verificadas em 18 de outubro de 2026, nas páginas do Bolt sobre projetos e arquivos, Git, banco de dados: avançado e tecnologias suportadas. Planos e recursos mudam, então confira na sua própria conta.
Perguntas
Posso rodar o Bolt.new localmente?
O criador, não: o bolt.new roda no navegador, nos servidores do Bolt. O irmão de código aberto dele, o bolt.diy, pode rodar localmente, mas é um projeto separado e que anda mais devagar. O seu projeto do Bolt, sim: baixe ou sincronize com o GitHub e rode com o Node.js.
Como rodo um projeto do Bolt.new localmente?
Baixe com Export → Download (ou clone do GitHub), instale o Node.js e rode
npm install && npm run dev na pasta do projeto. Isso sobe o front end. Um banco de
dados do Bolt Cloud continua no Bolt Cloud até você reivindicá-lo ou levá-lo para outro
lugar.
Posso instalar o Bolt.new no meu computador?
Não existe uma versão instalável do bolt.new. Se você quer um criador com IA que rode no seu próprio computador, o Zeltro é um: ele roda localmente, usa o seu próprio agente de IA e cria apps em PHP e Python, além de JavaScript. Veja a comparação completa com o Bolt.new.
O download do Bolt inclui o banco de dados?
Não. O zip é o seu código. A documentação do Bolt não diz que ele inclui o seu banco de dados ou os seus segredos, então planeje essas partes à parte: reivindique o banco de dados para o Supabase (plano Pro ou Teams) ou leve os dados para um banco de dados que você mesmo roda.
Posso continuar usando o Bolt depois de levar o projeto para o meu computador?
Sim, se você usar a sincronização com o GitHub. O Bolt faz commit das alterações dele no repositório e puxa as suas a cada 30 segundos. Trabalhe em um branch localmente e faça o merge no GitHub, já que o Bolt não faz merge de branches dentro do app.
Quanto custa o Zeltro?
O app Zeltro é grátis para uso pessoal, projetos de hobby e aprendizado, sem conta. Uma
empresa que usa o Zeltro, inclusive para trabalhos pagos para clientes, compra uma
licença comercial vitalícia uma única vez, por US$99.99. A
ferramenta de linha de comando zeltro é de código aberto (MIT). À parte, você paga a
sua IA: uma assinatura que você já tem, uma chave de API cobrada por uso, ou nada com um
modelo local.
Continue construindo o seu app do Bolt localmente
Instale o Zeltro, traga o seu projeto do Bolt pelo GitHub ou por um zip e continue editando com a IA que você já paga, ou com um modelo local gratuito. Grátis para uso pessoal, sem conta.
Instalar o Zeltro Por que trazer sua própria chave
Prefere não configurar você mesmo? Eu faço para você.
Verificado em 2026-10-18. Os outros produtos mudam com frequência: se algo aqui estiver desatualizado, avise a gente e a gente corrige.