Explorador de arquivos
A aba Arquivos do projeto mostra a pasta do seu código, como no computador. É dos planos pagos, a partir do Block.Editor de código
Abra e edite arquivos de texto de até 1 MB, com realce de sintaxe e formatação.
Arrastar do computador
Arraste arquivos, pastas ou um .zip: o painel envia só o que mudou, até 500 MB por arquivo, de qualquer tipo. O download sai por um link que vale 5 minutos e só para a sua conta.
Criar, renomear e mover
Crie arquivos e pastas, renomeie e mova arrastando para outra pasta, ou pelo Mover para… no menu do item.
Excluir
Apague arquivos e pastas que o projeto não usa mais.
Buscar nos arquivos
Ache um texto em todos os arquivos do projeto e abra o arquivo direto na linha.
Vários de uma vez
Marque vários itens para mover, excluir ou baixar num
.zip.O que fica protegido
node_modules,__pycache__e, no PHP comcomposer.json, a pastavendoraparecem só para leitura: elas são criadas pela instalação (o__pycache__, pelo Python quando o projeto roda; não é preciso mexer nele). Para mudar uma dependência, edite opackage.json, orequirements.txtou ocomposer.jsone use Aplicar mudanças. Para instalar tudo de novo, apague a pasta inteira.- O ambiente do Python (
venv) e as gems do Ruby não aparecem: ficam fora da pasta do projeto. - Atalhos (links simbólicos) aparecem na lista, mas não são abertos nem seguidos.
- Arquivos que não são texto (imagens,
.zip) não abrem no editor: baixe para abrir no computador.
Arrastar arquivos e pastas do computador
Não precisa compactar nada: arraste arquivos e pastas do seu computador para a lista da aba Arquivos, ou use Enviar › Enviar arquivos ou Enviar pasta. Soltos na lista, eles vão para a pasta aberta; soltos em cima de uma pasta da lista, vão para dentro dela, com as subpastas. Funciona como um commit: antes de gravar, o painel compara o que chegou com o que já está no projeto (pelo conteúdo de cada arquivo, calculado no seu navegador) e mostra, no Enviar mudanças:- os arquivos alterados e os novos, que são enviados;
- os iguais, que não são enviados de novo;
- os bloqueados, com o motivo (uma pasta com o mesmo nome no projeto, um atalho no caminho, a pasta das dependências), que ficam de fora.
- Um arquivo solto sozinho (como o
index.htmldo site) abre uma confirmação curta: “index.html foi alterado” › Enviar e aplicar. Se ele for igual ao do projeto, o painel avisa “Nada mudou” e não envia nada. - Arrastou um
.zip? Solto sozinho, o painel abre o.zipno seu navegador e compara os arquivos de dentro dele, como se você tivesse arrastado a pasta: só os novos e os alterados vão, e nada do projeto é apagado. Se o.ziptiver senha, mais de 5.000 arquivos ou mais de 512 MB depois de aberto, ele entra como um arquivo comum e o painel avisa o motivo; junto com outros arquivos ou dentro de uma pasta, também entra como arquivo. - Arrastou a pasta do projeto inteira? Escolha Só o conteúdo para os arquivos de dentro dela irem direto para a pasta aberta, ou Com a pasta para ela entrar como uma pasta nova. O painel já sugere a opção certa: se o que tem dentro dela já existe no projeto, é o conteúdo.
node_modules,.git,__pycache__,venv,.venv,.DS_StoreeThumbs.dbsão pulados sozinhos: as dependências a Cube instala a partir dopackage.json, dorequirements.txtou do manifesto da sua linguagem.- Até 500 MB por arquivo, de qualquer tipo (um
.jar, uma imagem, um banco SQLite). Na prática, o limite é o disco do projeto (1 GB no Free e 10 GB a partir do Block): se ele acabar no meio, o envio para e diz o que foi e o que ficou. - Com muitos envios acontecendo ao mesmo tempo, o painel mostra “Muitos envios agora” e continua sozinho em alguns segundos, do ponto onde estava.
- Se o envio parar no meio (sem internet, sem espaço), nada é aplicado e o painel diz quais arquivos foram e quais faltaram. Envie de novo: os que já foram aparecem como iguais.
Buscar nos arquivos
No campo Buscar texto nos arquivos, digite o que procura e aperte Enter. A busca olha o projeto inteiro e mostra, por arquivo, cada linha em que o texto aparece. Clique numa linha para abrir o arquivo no editor com o cursor nela; o Voltar do editor devolve os resultados.- O texto é procurado exatamente como você digitou (símbolos como
.*ou(valem como texto), sem diferença entre maiúsculas e minúsculas, com até 200 caracteres numa linha só. - Ficam de fora:
node_modules,.git,__pycache__,venve.venv, atalhos, arquivos que não são texto e os maiores que 1 MB. - A busca mostra até 200 resultados e para em 10 segundos. Se ela parar antes do fim, o painel avisa: busque um texto mais específico para achar o resto.
Selecionar vários
Marque a caixa ao lado de cada arquivo ou pasta (ou a do cabeçalho, para marcar todos da pasta aberta; no celular, Marcar todos na barra). Com um ou mais marcados, a barra da seleção oferece:- Mover para…: escolha a pasta de destino; cada item vai para lá com o mesmo nome.
- Baixar .zip: o painel monta um
.zipsó com os itens marcados (com o que está dentro das pastas) e o navegador baixa. O link vale 5 minutos e só para a sua conta. Até 500 MB e 20.000 arquivos; atalhos e as pastas das dependências ficam de fora. Um.zippor vez em cada conta: se outro ainda estiver baixando, espere ele terminar. - Excluir: pede confirmação com a lista do que vai ser apagado. Não dá para desfazer.
node_modules, vendor) entra na seleção só para excluir: ela não muda de lugar. O que fica dentro dela e o __pycache__ não entram.
Apagar a pasta das dependências
O caminho que você já conhece: apague a pastanode_modules e inicie ou reinicie o projeto, que as dependências são instaladas de novo.
- Na aba Arquivos, abra o menu … da pasta
node_modules(no PHP comcomposer.json, a pastavendor) e clique em Apagar pasta. Ela também entra na seleção, para excluir junto com outros itens. - Confirme: “Apagar node_modules? As dependências são instaladas de novo quando você iniciar ou reiniciar o projeto.”
- Clique em Iniciar ou Reiniciar (no painel, pela API, pela CLI ou por Cube AI). Antes de subir, o projeto passa por Instalando, e Logs › Instalação começa com “Instalando as dependências: a pasta node_modules não existe.”. No fim, ele volta ao ar.
- Só a pasta inteira sai. Editar, criar ou apagar um arquivo dentro dela continua bloqueado: meia pasta de dependências quebra o projeto de um jeito difícil de entender.
- Com a pasta no lugar, Iniciar e Reiniciar continuam como sempre, rápidos e sem instalar nada.
- Se o projeto cair sozinho antes de você reiniciar, o reinício automático não instala: ele volta com o que tem. Reinicie você para instalar.
- Aplicar mudanças e um .zip novo também instalam o que falta.
- O apagar fica na Atividade, e a instalação no Histórico de envios como “Dependências reinstaladas”.
- Se a pasta sumir de outro jeito (o seu código apagou o
node_modules, por exemplo), Iniciar e Reiniciar também instalam antes de subir. Vale para o ambiente do Python, as gems do Ruby e as dependências do Elixir, que ficam fora da pasta do projeto e não aparecem aqui (para instalá-los do zero, use o Reinstalar dependências, abaixo). Com um comando de instalação próprio, só o apagar por aqui conta.
Reinstalar dependências
Quando uma dependência ficou quebrada ou pela metade, use Reinstalar dependências, ao lado de Aplicar mudanças. Ele apaga a pastanode_modules (no Python, o ambiente das dependências; no Go, os módulos baixados; no PHP, a pasta vendor; no Ruby, as gems instaladas; no .NET, os pacotes do NuGet baixados; no Elixir, as dependências e o que foi compilado; no Rust, os crates baixados e a target) e instala tudo de novo a partir do package.json, do requirements.txt (ou do pyproject.toml), do go.mod, do composer.json, do Gemfile, do projeto do .NET ou do mix.exs, mesmo que eles não tenham mudado. As edições ainda não aplicadas vão junto.
- O projeto sai do ar durante a instalação e volta sozinho no fim, se estava no ar.
- Acompanhe em Logs › Instalação: a primeira linha é “Reinstalando as dependências do zero”.
- O envio aparece no Histórico de envios como “Dependências reinstaladas”.
- Não aparece no site estático nem no Java, que não instalam dependências.
- Prefere o caminho de sempre? Apague a pasta das dependências e reinicie: dá no mesmo, com o projeto no ar até você reiniciar.
Aplicar mudanças
Editar um arquivo não reinicia nada sozinho. Quando terminar, clique em Aplicar mudanças:- Se o
package.json, opackage-lock.jsonou orequirements.txtmudou, as dependências são instaladas de novo. Se não mudou, a instalação é pulada. - O build roda de novo, se o projeto tiver um.
- Se o projeto estava no ar, ele volta com o código novo.
Pela API
Os arquivos do projeto também saem pela API, com uma chave de API com a permissão Arquivos · ler (files:read: listar, ler, buscar, baixar) ou Arquivos · escrever (files:write: escrever, enviar até 500 MB em partes, mover e apagar). Valem as mesmas regras do painel: só nos planos pagos, só os arquivos da sua conta, a pasta das dependências só leitura e cada ação na Atividade com o nome da chave. O link de download vale 5 minutos e só abre com a mesma chave. Depois de mexer, aplique as mudanças.
Atualizar o código com um novo .zip
Em Configurações › Deploy, use Enviar .zip para trocar o código inteiro do projeto. Vale em todos os planos, inclusive no Free. Pela API, é o Enviar novo código.- A configuração do projeto (tipo, linguagem, comando e memória) continua a mesma. Um
cube.jsondiferente no.zipnovo é ignorado. - As dependências só são instaladas de novo se o manifesto mudou.
- Se o
.zipfor recusado, os arquivos de antes ficam como estavam.
Onde o seu app pode gravar
O seu código pode criar e gravar arquivos dentro da pasta do projeto (um banco SQLite, um JSON de configuração, uploads). Eles ficam guardados entre reinícios, mas um novo .zip substitui a pasta. Fora dela, só/tmp, que é pequeno e apagado quando o projeto reinicia.
Cada projeto tem um disco próprio, com o tamanho do seu plano: 1 GB no Free, 10 GB no Block, no Stack e no Tower, 20 GB no Fortress, 40 GB no Monolith e 50 GB no Empresas (veja Disco por projeto). As dependências instaladas e o que o build gera também contam. Embaixo da lista da aba Arquivos fica o quanto o projeto usa (“Disco do projeto: 875 MB de 10 GB”), e o mesmo número aparece no cartão do projeto e em Uso. Se o disco encher, novas gravações falham (disk_full): apague o que o projeto não usa ou mude para um plano com mais disco.

