Quais arquivos são excluídos no deploy?
Você enviou sua aplicação para a Square Cloud e percebeu que algumas pastas ou arquivos desapareceram do seu painel? Não se preocupe, isso é um comportamento padrão e intencional da nossa plataforma!
Ao realizar o deploy, a Square Cloud faz uma "limpeza" automática no seu pacote, removendo arquivos de ambiente de desenvolvimento local, caches de frameworks e pastas de dependências (como a pesada node_modules).
Fazemos isso por dois motivos principais:
- Velocidade e Desempenho: Evita o tráfego de dados desnecessário, tornando o seu deploy muito mais rápido.
- Economia de Espaço: Arquivos locais e caches não são necessários para a sua aplicação rodar no ambiente de produção. As dependências reais serão instaladas automaticamente pelo nosso sistema.
Quais arquivos são excluídos automaticamente?
Ao criar a aplicação (upload), a Square Cloud apaga da raiz do projeto os arquivos e pastas abaixo. Nos commits e deploys pelo GitHub eles não são removidos, então deixe-os fora do zip. Separamos a lista por categorias para facilitar o entendimento:
Dependências e Ambientes Virtuais:
node_modules.venv.npm.composer.bundle__pycache__
Caches de Frameworks e Builds:
.next/cache.nuxt/cache.cache
Sistema e Controle de Versão:
.git.local.mongodb.bash_logout.bashrc.profile
Configurações de Editores e Ferramentas:
.vscode.husky.logs
O que eu preciso fazer?
Para garantir um deploy eficiente, a melhor prática é nem mesmo enviar esses arquivos. Antes de fazer o upload do seu .zip ou de enviar seus arquivos, certifique-se de que essas pastas foram deixadas de fora do pacote. Use um arquivo squarecloud.ignore na raiz do projeto (sintaxe do .gitignore): a CLI (upload, commit e zip) e a extensão do VS Code o leem e já deixam node_modules, .git, .github e .vscode de fora por padrão.
Se você acabar enviando essas pastas por engano, não há problema algum: a Square Cloud fará o trabalho de excluí-las por você para garantir que sua aplicação continue limpa e leve.
Atualizado em: 04/10/2026
Obrigado!