
Resposta direta
React com Vite normalmente gera uma interface estática que precisa ser publicada junto com os assets do build. Autenticação, banco e chamadas privadas de IA exigem um backend. Variáveis VITE_ são incorporadas ao código do navegador e não servem para guardar segredos.
Uma IA pode gerar rapidamente um dashboard, um catálogo ou a interface de um SaaS. O resultado visual ajuda a validar a ideia, mas não demonstra que dados, permissões e publicação estão prontos. Em um projeto React com Vite, o trabalho de produção começa ao descobrir o que roda no navegador, o que depende de uma API e quais informações precisam permanecer no servidor.
- Build da interface
- Entrega pelo servidor web
- API autenticada
- Dados e serviços externos
Transforme a demonstração em um mapa da aplicação
Percorra a interface e marque cada ação: login, gravação, upload, relatório, pagamento e resposta de IA. Identifique quais telas usam dados fixos e quais consultam serviços reais. Uma tabela preenchida com exemplos não representa um banco de dados; um botão que muda o estado local não prova que a alteração foi persistida.
Imagine um sistema de atendimento gerado com IA. A interface pode listar chamados e sugerir respostas, mas a aplicação ainda precisa verificar quem pertence a cada empresa, registrar mudanças e limitar o uso do modelo. Escreva três jornadas completas e teste-as com duas contas diferentes. Essa validação vale mais que publicar todas as telas ao mesmo tempo.
Entenda o build de Vite
A documentação do Vite descreve a produção de um bundle de publicação e o diretório dist como saída padrão. Para um frontend estático, envie o resultado do build ao webroot. Vite é uma ferramenta de desenvolvimento e build; seu comando preview não é o servidor de produção da aplicação.
O exemplo abaixo pressupõe scripts usuais de um projeto Vite com npm e lockfile. Confira o package.json antes de executar. Uma instalação reproduzível permite distinguir um erro no código de uma diferença entre dependências do computador e do ambiente de publicação.
npm ci
npm run build
npm run previewProteja as variáveis e prepare a API
No Vite, variáveis com prefixo VITE_ ficam acessíveis ao código do cliente e entram no bundle. Use esse mecanismo para configurações públicas, como o endereço da API, e nunca para a chave de um provedor de IA, a senha SQL ou um segredo de pagamento. Trocar uma variável de build normalmente exige gerar e publicar uma nova versão.
A interface deve chamar seu backend autenticado. Esse backend recebe a solicitação, valida limites e consulta o serviço externo com a chave armazenada no servidor. Defina também origem permitida, tratamento de falhas e prazo de resposta. Exibir uma mensagem de erro clara ajuda o cliente e permite investigar o incidente sem mostrar credenciais.
Publique a interface na WordPane
Crie ou conecte a infraestrutura na área do cliente. No painel de controle, prepare a aplicação personalizada e o domínio, confira o webroot e publique o conteúdo de dist pelo File Manager, SFTP ou seu fluxo de artefatos. A instalação do Node no servidor de produção não é obrigatória para uma interface totalmente estática gerada em outro ambiente.
Se o projeto usa navegação SPA, testar somente a página inicial não basta. Abra uma rota como /clientes/123 diretamente em uma nova janela. Quando o roteamento precisa de fallback para index.html, configure-o no servidor web conforme a stack. Não copie uma regra .htaccess para Nginx: cada servidor tem mecanismos próprios.
Escolha o backend pelo requisito, não pelo nome do frontend
React pode se comunicar com um backend PHP, Node ou um serviço externo. Na WordPane, o ambiente Node.js está em beta e o catálogo PHP oferece outras possibilidades. Liste motor do banco, versão do runtime, processos contínuos e armazenamento antes de decidir. O frontend React não exige automaticamente MongoDB nem um banco de vetores.
Se a ferramenta de IA gerou integração com um serviço específico, preserve o contrato de autenticação e dados ou planeje a substituição. Exportar o repositório não migra automaticamente usuários, buckets, funções e tabelas do provedor original. Faça uma relação desses serviços e confira quais permanecerão externos.
Teste antes de convidar os primeiros clientes
- Verifique login, recuperação de acesso e encerramento da sessão.
- Grave um registro, recarregue a página e confirme persistência.
- Use duas contas e confirme isolamento dos dados.
- Abra links internos diretamente e teste uma página inexistente.
- Simule a falha da API e o limite de uso da IA.
- Confira o bundle publicado para garantir que não contém segredos.
- Mantenha a versão anterior e teste a recuperação do site.
Rota da interface e rota da API precisam de respostas diferentes
Em uma SPA, o navegador pode abrir /clientes/123 e deixar o roteador React decidir a tela. O servidor precisa saber como tratar essa navegação direta. Um fallback para index.html pode resolver rotas da interface, mas não deve transformar uma API inexistente em uma resposta HTML de sucesso.
Separe os caminhos de arquivos, frontend e API. Um arquivo JavaScript ausente precisa retornar erro identificável; devolver index.html no lugar dele costuma causar falha de módulo ou MIME. Para uma API, preserve códigos como 401, 403 e 404 e um formato de erro coerente com o cliente.
Exemplo: assistente que exige login
O usuário envia uma pergunta à API do projeto. A API verifica a sessão, autoriza o acesso aos documentos daquele usuário e só então chama o provedor de IA. O frontend recebe o resultado permitido; ele não recebe a chave do provedor nem decide sozinho quais documentos podem entrar no contexto.
Teste também a requisição fora da interface, com sessão ausente ou expirada. Esconder um botão no React não impede acesso ao endpoint. CORS organiza quais origens podem ler respostas no navegador, mas não substitui autenticação ou autorização no servidor.
Critérios de aceite para sair da demonstração
Uma tela funcionando com dados simulados é um começo. A entrega precisa provar que dados persistem, erros são explicados e o usuário não recebe confirmações de operações que falharam. Inclua indisponibilidade da API e interrupção de rede no ensaio.
Na WordPane, confirme onde o frontend será servido e onde cada serviço de backend será executado. Se o projeto for apenas estático, Node pode ser necessário somente no build. Se houver backend Node, confirme os requisitos do processo e da stack antes da publicação.
- Atualizar uma rota interna mantém a tela correta.
- Uma sessão expirada leva a uma ação de login clara, sem revelar dados.
- Uma falha no envio não gera registros duplicados após nova tentativa.
- Nenhuma chave privada aparece nos arquivos JavaScript publicados.
- Logs permitem relacionar um erro da interface à requisição do backend.
Planeje atualizações e o consumo
Integre Git quando essa opção estiver disponível na aplicação. Defina onde o build acontece e qual branch representa produção. Uma atualização automática útil inclui um resultado publicado e validado; apenas baixar código-fonte não conclui o deploy de Vite. Evite misturar arquivos enviados manualmente com atualizações automáticas sem um procedimento definido.
O painel WordPane ajuda a reunir domínio, arquivos, logs e recuperação do ambiente. Na área do cliente, acompanhe consumo por hora e operações. Use um teste real para dimensionar a infraestrutura; custos de API, autenticação externa e modelos são independentes. Esse arranjo ajuda a passar do protótipo visual para uma operação organizada sem esconder as responsabilidades do aplicativo.
Escolha o ambiente do projeto
Compare os planos ou envie os requisitos da aplicação para a equipe WordPane.
Configurar meu projeto na WordPaneConsultar a documentação do painel
