Como configurar seu projeto Fullstack para rodar sem erros.
Na BuhCloud, seu app não pode usar uma porta fixa (como a 3000). Nosso sistema aloca uma porta dinâmica para cada projeto para que vários apps rodem ao mesmo tempo sem conflito.
// ❌ JEITO ERRADO (Causa erro EADDRINUSE)
app.listen(3000, () => { ... });
// ✅ JEITO CERTO (Obrigatório na BuhCloud)
const PORT = process.env.PORT || 3000;
app.listen(PORT, '0.0.0.0', () => {
console.log(`Servidor rodando na porta ${PORT}`);
});
Copie o texto abaixo e mande para a IA antes de gerar o código do seu app:
"Estou criando um app para a BuhCloud. Regras obrigatórias: 1. Use a porta dinâmica: 'const PORT = process.env.PORT || 3000'. 2. Ouça em host '0.0.0.0'. 3. No package.json, o script 'start' deve rodar o servidor. 4. IMPORTANTE: Como o app pode rodar em um caminho subjacente (ex: /app/meuapp/), certifique-se de que os assets (CSS/JS) usem caminhos relativos ou que o 'base' do Vite/Next seja configurável via variável de ambiente."
Se o seu app abrir mas o CSS e JS derem erro 404, é porque o app está tentando buscar na raiz do domínio. No Vite, resolva assim:
// vite.config.js
export default defineConfig({
base: './', // 👈 Isso faz os caminhos serem relativos e funcionarem em qualquer lugar!
// ... resto da config
})
Aprenda a conectar seu app ao sistema de armazenamento de arquivos da BuhCloud. Segredos de autenticação, chaves de API e rotas seguras.
Ver Guia BuhDrive completo →
Você não precisa de um arquivo .env no seu ZIP. Use o botão Variáveis (Env) no Dashboard para cadastrar chaves de API, senhas de banco e outras configurações. Elas serão injetadas automaticamente no process.env do seu app.