Como fazer deploy de um site estático com o Trapiche

Introdução

Publicar um site estático não precisa ser complicado. Com o Trapiche Cloud, você conecta seu repositório GitHub e em poucos minutos tem seu site no ar com HTTPS automático e domínio personalizado.

Neste tutorial, vamos mostrar como fazer deploy de um projeto frontend do zero.

Pré-requisitos

Antes de começar, você vai precisar de:

Uma conta no GitHub
Um projeto frontend (React, Vite, Next.js com output: 'export', ou qualquer gerador de site estático)
Repositório no GitHub (público ou privado)

Passo 1: Acessar o Dashboard

Acesse dashboard.trapiche.cloud e faça login com sua conta GitHub. O Trapiche vai pedir permissão para acessar seus repositórios.

Passo 2: Criar um novo deploy

No dashboard, clique em “Novo Deploy” e selecione o repositório que deseja publicar. Escolha a branch (geralmente main) e confirme.

# O Trapiche executa automaticamente:
git clone --depth=1 <seu-repositório>
npm install
npm run build

O sistema detecta automaticamente o tipo do projeto:

Framework	Diretório de build
Next.js (com `output: 'export'`)	`out`
Vite	`dist`
Create React App	`build`

Passo 3: Acompanhar o build

Após iniciar o deploy, você pode acompanhar os logs em tempo real na página do deployment. O processo inclui:

Clone do repositório
Detecção do framework
Instalação das dependências (npm install)
Build do projeto (npm run build)
Upload dos arquivos para a nuvem

Passo 4: Acessar seu site

Quando o build terminar, seu site estará disponível em:

https://nome-do-projeto.trapiche.site

O Trapiche gera automaticamente um nome único para cada deployment.

Configurar domínio personalizado

Quer usar seu próprio domínio? É simples:

1. Adicionar o domínio

No dashboard, acesse o deployment e clique em “Adicionar Domínio”. Digite seu domínio (ex: meusite.com.br).

2. Configurar DNS

Adicione os seguintes registros no seu provedor de DNS:

TXT  _trapiche-verification.meusite.com.br  trapiche-verify=<token>
A    meusite.com.br                         201.23.1.151

3. Verificar

Clique em “Verificar” no dashboard. O Trapiche consulta múltiplos servidores DNS para confirmar a configuração. Após a verificação, o certificado SSL é emitido automaticamente.

Dica: A propagação DNS pode levar até 48 horas, mas geralmente é bem mais rápida.

Fazendo redeploy

Sempre que quiser atualizar seu site, basta acessar o dashboard e clicar em “Redeploy”. O Trapiche vai buscar a versão mais recente do seu repositório e repetir o processo de build.

Dicas para Next.js

Se você usa Next.js, certifique-se de que seu next.config.js inclui a configuração de export estático:

/** @type {import('next').NextConfig} */
const nextConfig = {
  output: 'export',
}

module.exports = nextConfig

Isso é necessário porque o Trapiche serve apenas sites estáticos — funcionalidades que dependem de um servidor Node.js (como API Routes ou Server Components) não são suportadas.

Conclusão

Com o Trapiche, publicar um site estático é rápido, gratuito e sem complicação. Conecte seu GitHub, faça o deploy e tenha seu site online em minutos.

Próximos passos:

Explore a documentação completa
Configure um domínio personalizado
Experimente fazer deploy de diferentes frameworks