Criação de sites com IA e publicação do site
Publicar site React criado com IA na Vercel (2026): Vite, variáveis e tela branca
Publique um frontend React + Vite gerado por IA usando GitHub e Vercel. Confira o build, as variáveis públicas, o erro 404 ao atualizar páginas e as imagens antes de compartilhar.

A ferramenta de IA exportou seu site em React, mas o arquivo veio com componentes .tsx, uma pasta src e package.json. Para publicar, é preciso gerar o build e hospedar o resultado. Este tutorial usa React + Vite como aplicação de página única no navegador, com GitHub e Vercel.
Ao terminar, você deverá ter um endereço HTTPS em que funcionem a página inicial, as páginas internas e as imagens. O procedimento foi preparado com documentação oficial consultada em 20 de novembro de 2026; não é um relato de teste do seu projeto específico.
Abra package.json. Um projeto básico de Vite costuma ter scripts como estes:
{
"scripts": {
"dev": "vite",
"build": "vite build",
"preview": "vite preview"
}
}
Preserve os scripts válidos do projeto, incluindo uma possível checagem de TypeScript antes do build.
| O que você recebeu | Como seguir |
|---|---|
Vite, src, index.html e package.json | Siga este procedimento para frontend |
| Apenas HTML, CSS e imagens | Use o tutorial para publicar HTML |
next, next build e configuração de Next.js | Use a configuração do framework Next.js |
| Um componente React sem projeto completo | Peça à IA os arquivos de entrada, dependências e scripts necessários |
| Backend separado, banco ou renderização no servidor | Defina também como esses serviços serão publicados |
A presença de index.html no código-fonte não elimina o build. Veja a documentação de publicação estática do Vite.
Crie um repositório. Ele pode ser privado, desde que você permita o acesso pela integração do GitHub com a Vercel. Se a ferramenta de IA oferece sincronização com GitHub, use essa opção. Se recebeu um ZIP, extraia e envie os arquivos pelo GitHub ou por um cliente Git.
Inclua código, imagens utilizadas, configuração e o arquivo de lock do gerenciador de pacotes. Mantenha npm, pnpm ou Yarn conforme o projeto original. Não envie node_modules nem arquivos com credenciais. O ZIP fechado não substitui os arquivos do projeto.
Depois do commit, abra as pastas no repositório para conferir o conteúdo. Se a aplicação estiver em meu-site/, você precisará selecionar essa pasta na configuração da hospedagem.
Em um projeto npm com dependências já instaladas, é possível conferir o build localmente:
npm run build
npm run preview
Confira a página inicial e as imagens nessa prévia. vite preview serve para verificar o build local, não para manter o site em produção. Você também pode continuar sem ambiente local e acompanhar os logs de build na Vercel.
Na Vercel, crie um projeto, conecte o GitHub e selecione o repositório. Antes de clicar em Deploy, confira os campos abaixo. O guia de primeiros passos mostra as opções atuais de importação.
| Campo | Configuração comum de React + Vite |
|---|---|
| Framework Preset | Vite |
| Root Directory | Pasta da aplicação que contém package.json |
| Build Command | Geralmente npm run build, conforme scripts e gerenciador |
| Output Directory | dist, salvo alteração em build.outDir |
Em geral, src e public não são a saída final do projeto. Também não coloque npm run dev como comando de build: ele inicia um servidor de desenvolvimento. Consulte a configuração de build da Vercel antes de substituir os valores detectados.
Se falhar, abra Build Logs e procure o primeiro erro relacionado à falha. Script build ausente pede uma revisão do diretório e de package.json; módulo ausente pede verificar a dependência e a importação; saída inexistente pede comparar o diretório configurado com o resultado do build. Corrija no mesmo repositório e acompanhe o novo deploy.
Um site apenas de apresentação pode não precisar de variáveis. Se ele usa uma API, adicione as necessárias em Environment Variables do projeto e selecione o ambiente correto. Na primeira importação, confira os valores de Production; configure Preview separadamente para as prévias de outras branches. A documentação de ambientes da Vercel explica a diferença.
Um endereço público de backend poderia ser:
VITE_API_BASE_URL=https://api.example.com
Leia com o mesmo nome no código:
const apiBaseUrl = import.meta.env.VITE_API_BASE_URL;
Troque o domínio de exemplo pela sua API HTTPS publicada. O Vite inclui valores VITE_ no código enviado ao navegador. Chaves privadas de modelos, senhas de banco e tokens de administrador devem ficar em um backend ou função de servidor com controle de acesso. Mudar o nome da variável não cria esse serviço. Veja as variáveis de ambiente do Vite.
Depois de alterar variáveis, faça um novo deploy. Os anteriores continuam com os valores antigos, como explica a documentação da Vercel.
Se a aba Network mostra chamadas para localhost:8000, o navegador está tentando acessar o computador do visitante. Configure a API publicada e confira se o backend permite a origem do site em produção. Teste também o salvamento real e a autenticação, seguindo o guia de formulários e login.
Você entra em /about pelo menu, mas recebe 404 ao abrir a URL em outra aba ou atualizar. O roteador do navegador conhece a página; a hospedagem precisa saber qual arquivo entregar quando essa rota é solicitada diretamente.
Para uma SPA Vite apenas de frontend, crie vercel.json ao lado do package.json da aplicação:
{
"$schema": "https://openapi.vercel.sh/vercel.json",
"rewrites": [
{ "source": "/(.*)", "destination": "/index.html" }
]
}
Faça commit, publique novamente e teste a abertura direta e a atualização de /about. Essa regra segue as instruções da Vercel para SPA com Vite.
O exemplo pressupõe cleanUrls desativado e ausência de rotas API personalizadas. Se já houver configuração, combine as regras sem apagar as anteriores. Projetos com API, proxy, SSR ou roteamento do framework precisam de tratamento conforme sua estrutura. O fallback também não recupera um arquivo JavaScript ausente.
Abra as ferramentas do navegador, confira Console e Network e atualize. Registre o primeiro erro, além da URL, status e Content-Type da requisição problemática.
| Sintoma | O que conferir |
|---|---|
.js responde com 404 ou HTML | Arquivos do build, caminhos, base do Vite e rewrites |
| Uma imagem não aparece | Arquivo no repositório, caminho e letras maiúsculas/minúsculas |
| Página inicial retorna 200, mas fica vazia | Erro de execução e componente indicado no Console |
| Formulário informa sucesso sem registro | Resposta real da API e sistema que recebe os dados |
| Visitante encontra o login da Vercel | URL compartilhada e proteção do deploy |
Normalmente public/cover.png é referenciado por /cover.png; imagens em src podem ser importadas para processamento no build. Confira se sobrou um base de uma publicação anterior em subpasta. Consulte a documentação de arquivos estáticos do Vite.
Antes de compartilhar o domínio de produção, abra-o sem sessão iniciada. Teste página inicial, rota interna, atualização, celular e ação principal. Confirme uma submissão no destino e o domínio de retorno do login. Confira as condições e limites do plano de acordo com o uso pretendido.
Para atualizar depois, faça commit na branch de produção configurada e verifique o deploy correspondente. Se a nova versão causar falhas, siga o tutorial de publicação e rollback.