Trapiche logo trapiche
5 min de leitura Trapiche Team

Como fazer deploy de um site Vite grátis no Brasil

Se voce ja tentou colocar um projeto Vite no ar, provavelmente caiu em tutoriais que mandam usar Vercel, Netlify ou alguma outra plataforma gringa. Funciona? Funciona. Mas o servidor fica nos EUA, a latencia pro Brasil e alta e, no fim do mes, a cobranca vem em dolar. Se o cambio sobe, seu custo sobe junto.

Neste tutorial, voce vai aprender a fazer deploy de um site Vite gratis, hospedado no Brasil, com HTTPS automatico e deploy continuo. Tudo em portugues, tudo em real.

Pre-requisitos

Antes de comecar, voce vai precisar de:

  • Uma conta no GitHub
  • Node.js instalado (versao 18 ou superior)
  • Um projeto Vite pronto — ou vamos criar um do zero no proximo passo

Passo 1: Criar o projeto Vite

Se voce ja tem um projeto Vite, pule para o Passo 2. Caso contrario, abra o terminal e rode:

npm create vite@latest meu-site -- --template react

Isso cria um projeto React com Vite. Voce pode trocar react por vue, svelte ou qualquer outro template que preferir.

Agora entre na pasta e instale as dependencias:

cd meu-site
npm install

Para verificar que tudo esta funcionando, rode o servidor de desenvolvimento:

npm run dev

Acesse http://localhost:5173 no navegador. Se a pagina carregou, esta tudo certo.

Por fim, gere o build de producao para confirmar que a pasta dist/ e criada corretamente:

npm run build

Voce deve ver uma pasta dist/ na raiz do projeto com os arquivos otimizados. Esse e o conteudo que vai pro servidor.

Passo 2: Subir para o GitHub

O Trapiche faz deploy direto do seu repositorio no GitHub. Entao, o proximo passo e subir o codigo.

Inicialize o repositorio e faca o primeiro commit:

git init
git add .
git commit -m "primeiro commit"

Crie um repositorio no GitHub (pode ser publico ou privado) e conecte o remoto:

git remote add origin https://github.com/seu-usuario/meu-site.git
git branch -M main
git push -u origin main

Pronto. Seu codigo esta no GitHub e pronto para o deploy.

Passo 3: Fazer deploy no Trapiche

Agora vem a parte mais rapida.

  1. Acesse dashboard.trapiche.cloud
  2. Faca login com sua conta do GitHub
  3. Clique em Novo Deploy
  4. Selecione o repositorio meu-site
  5. Escolha a branch main

O Trapiche detecta automaticamente que o projeto usa Vite e configura o build para voce. Nao precisa mexer em nada.

A deteccao automatica funciona assim:

FrameworkBuild commandOutput dir
Vitenpm run builddist

Se o seu projeto tiver uma configuracao diferente (por exemplo, um outDir customizado no vite.config.js), voce pode ajustar manualmente antes de confirmar o deploy. Mas na maioria dos casos, o padrao ja resolve.

Clique em Deploy e pronto.

Passo 4: Acompanhar o build

Depois de iniciar o deploy, voce acompanha o progresso em tempo real direto no dashboard. O log mostra cada etapa:

  1. Clone — o Trapiche clona o repositorio do GitHub
  2. Detect — identifica o framework e as configuracoes de build
  3. Install — roda npm install para instalar as dependencias
  4. Build — executa npm run build e gera os arquivos de producao
  5. Upload — envia o conteudo da pasta dist/ para o servidor em Sao Paulo

O processo inteiro costuma levar menos de um minuto para projetos Vite, que sao naturalmente rapidos de buildar.

Se algo der errado, o log mostra exatamente onde o erro aconteceu. Na maioria das vezes, e o mesmo erro que voce veria rodando npm run build localmente.

Passo 5: Acessar seu site

Assim que o deploy terminar, seu site fica disponivel em:

https://meu-site.trapiche.cloud

O subdominio e gerado automaticamente com base no nome do repositorio. O HTTPS ja vem configurado — sem necessidade de mexer com certificados ou DNS.

Se voce quiser usar um dominio proprio (por exemplo, meusite.com.br), basta adicionar no painel. O Trapiche gera e renova o certificado SSL automaticamente.

Passo 6: Deploy automatico

A partir de agora, cada git push na branch main dispara um novo deploy automaticamente.

# faz uma alteracao no codigo
git add .
git commit -m "atualiza pagina inicial"
git push

Em poucos segundos, o Trapiche detecta o push, roda o build e atualiza o site. Voce nao precisa acessar o dashboard nem clicar em nada. E deploy continuo de verdade.

Por que hospedar no Brasil?

A diferenca de performance entre um servidor em Sao Paulo e um servidor nos EUA e brutal para usuarios brasileiros. Veja a comparacao:

PlataformaServidorLatencia no Brasil
TrapicheSao Paulo~5-15ms
VercelEUA~120-200ms
NetlifyEUA~120-200ms

Essa diferenca de latencia afeta diretamente o tempo de carregamento da pagina, a experiencia do usuario e ate o SEO — o Google leva performance em conta no ranking.

Alem da latencia, hospedar no Brasil com o Trapiche traz outras vantagens:

  • Preco em real (BRL): sem surpresas com variacao cambial. Voce sabe exatamente quanto vai pagar.
  • Plano gratuito generoso: ideal para projetos pessoais, portfolios e MVPs.
  • Suporte em portugues: quando voce precisar de ajuda, a comunicacao e na sua lingua.
  • Dados no Brasil: para projetos que exigem conformidade com a LGPD, ter os dados hospedados no pais simplifica bastante.

Conclusao

Fazer deploy de um site Vite nao precisa ser complicado nem caro. Com o Trapiche, voce sai do npm run build para um site no ar em poucos minutos, com servidor no Brasil, HTTPS automatico e deploy continuo.

Se voce ainda esta pagando em dolar para hospedar um site estatico, vale experimentar. Crie sua conta gratuita em dashboard.trapiche.cloud e faca seu primeiro deploy agora.