Pular para o conteúdo principal

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 com composer.json, a pasta vendor aparecem 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 o package.json, o requirements.txt ou o composer.json e 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.
Clique em Enviar para mandar só os novos e os alterados, um por vez, com o progresso na tela (dá para cancelar no meio). Nada do projeto que não veio no envio é apagado. Com Aplicar mudanças depois de enviar ligado (o padrão), o projeto aplica as mudanças sozinho no fim (veja Aplicar mudanças).
  • Um arquivo solto sozinho (como o index.html do 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 .zip no 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 .zip tiver 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_Store e Thumbs.db são pulados sozinhos: as dependências a Cube instala a partir do package.json, do requirements.txt ou 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.
O .zip do Novo projeto e do Enviar .zip continua com o limite do plano (5 MB no Free e 10 MB nos pagos). Um arquivo maior, como um .jar, entra por aqui depois de o projeto existir.

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__, venv e .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 .zip só 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 .zip por 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.
São até 100 itens por vez, da mesma pasta. Se um item não der certo (um arquivo com o mesmo nome no destino, por exemplo), os outros seguem e o painel diz qual ficou e por quê. A pasta inteira das dependências (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 pasta node_modules e inicie ou reinicie o projeto, que as dependências são instaladas de novo.
  1. Na aba Arquivos, abra o menu … da pasta node_modules (no PHP com composer.json, a pasta vendor) e clique em Apagar pasta. Ela também entra na seleção, para excluir junto com outros itens.
  2. Confirme: “Apagar node_modules? As dependências são instaladas de novo quando você iniciar ou reiniciar o projeto.”
  3. 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 pasta node_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:
  1. Se o package.json, o package-lock.json ou o requirements.txt mudou, as dependências são instaladas de novo. Se não mudou, a instalação é pulada.
  2. O build roda de novo, se o projeto tiver um.
  3. Se o projeto estava no ar, ele volta com o código novo.
Os arquivos aplicados ficam guardados como uma versão (“Edições nos arquivos” em Configurações › Deploy), para baixar ou voltar para eles depois.
Mudou só um .js ou .py? Reiniciar também serve: o processo novo já lê os arquivos editados.

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.
files:read dá acesso ao código, que pode ter segredos (o .env, um token esquecido). Ela fica fora do modelo Leitura, e o painel avisa quando está marcada (o Ler e escrever e o Tudo marcam): deixe só na chave que precisa.

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.json diferente no .zip novo é ignorado.
  • As dependências só são instaladas de novo se o manifesto mudou.
  • Se o .zip for recusado, os arquivos de antes ficam como estavam.
O .zip novo substitui a pasta inteira do projeto (só as dependências instaladas ficam). Arquivos que o seu app criou, como um banco SQLite ou uploads, somem se não estiverem no .zip. Faça um backup antes de enviar (ele guarda esses arquivos e dá para voltar atrás), baixe pelo explorador, ou use Aplicar mudanças para trocar só o que editou. Para atualizar só o que mudou, sem apagar nada, arraste o .zip na aba Arquivos: veja Arrastar arquivos e pastas do computador.
O Histórico de envios, na mesma seção, mostra os 20 últimos envios, edições aplicadas e trocas de versão, com o resultado de cada instalação.

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.

Excluir o projeto

Em Configurações › Geral, no fim da página, em Zona de perigo. O projeto para, os arquivos são apagados e o endereço do site deixa de funcionar. Não dá para desfazer, mas os backups ficam na página Backups por até 30 dias, para baixar ou restaurar como um projeto novo.