> For the complete documentation index, see [llms.txt](https://help.dataunix.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.dataunix.com.br/cloud-space/gerenciando-arquivos.md).

# Gerenciando arquivos

Envie, organize e edite os arquivos do seu site

Tudo o que você envia para o projeto é publicado na hora. Não existe botão de "publicar" nem espera: subiu, está no ar.

Para começar, abra o **Cloud Space**, clique em **Entrar no Projeto** e role até a área **Arquivos**.

> 📸 *Inserir print da área de arquivos com os botões Enviar pasta, Enviar arquivos e o ícone de nova pasta.*

{% hint style="warning" %}
O gerenciamento de arquivos funciona pelo **navegador do computador**. No aplicativo de celular você consegue ver o projeto, mas os botões de envio não aparecem.
{% endhint %}

## A página inicial do site

O visitante que acessa o endereço do seu projeto vê o arquivo **`index.html`** que estiver na raiz (em **Início**). Então, antes de tudo, garanta que o seu site tem um `index.html` fora de qualquer pasta.

## Enviando arquivos

Você tem três jeitos de fazer isso:

* **Enviar arquivos:** escolhe um ou vários arquivos do computador.
* **Enviar pasta:** escolhe uma pasta inteira. A estrutura de subpastas é mantida do jeitinho que está no seu computador.
* **Arrastar e soltar:** arraste arquivos ou pastas direto para a área tracejada.

Os arquivos vão sempre para a **pasta que está aberta** no momento. Se você entrou em `img`, o que enviar vai para `img`.

Em envios grandes, o painel mostra o progresso (por exemplo, "Enviando 50 de 120 arquivos"). No final aparece o resumo: quantos foram enviados, quantos foram ignorados por formato não aceito e, se algum falhar, qual foi.

{% hint style="info" %}
Enviar um arquivo com o mesmo nome e no mesmo lugar de um que já existe **substitui** o antigo. É assim que você atualiza o site.
{% endhint %}

### Formatos aceitos

| Tipo             | Extensões                                                                                     |
| ---------------- | --------------------------------------------------------------------------------------------- |
| Páginas e código | `.html` `.css` `.js` `.mjs` `.cjs` `.map` `.json` `.jsonld` `.xml` `.webmanifest` `.manifest` |
| Imagens          | `.jpg` `.jpeg` `.png` `.gif` `.svg` `.webp` `.avif` `.ico` `.bmp`                             |
| Fontes           | `.woff` `.woff2` `.ttf` `.otf` `.eot`                                                         |
| Documentos       | `.txt` `.md` `.csv` `.pdf`                                                                    |
| Mídia            | `.mp4` `.webm` `.mp3` `.ogg`                                                                  |

### Limites

* **10 MB por arquivo**
* **200 MB por projeto** (a barra de Armazenamento, em Informações, mostra quanto já foi usado e fica vermelha acima de 80%)

{% hint style="success" %}
Funciona com qualquer site estático: HTML, CSS e JS puros ou o resultado do build de React, Vue, Astro, Hugo, Eleventy ou Vite. Envie o conteúdo da pasta de build (normalmente `dist` ou `build`), não o projeto com código-fonte.
{% endhint %}

## Organizando em pastas

Clique no ícone de **nova pasta** (ao lado de Enviar arquivos), dê um nome e pronto. A pasta é criada dentro da pasta aberta.

No nome use letras, números, ponto, hífen ou underscore. Espaços e acentos viram underscore automaticamente.

Para navegar, clique no nome da pasta. Para voltar, use o caminho que aparece acima da lista (começa em **Início**).

## Ações de cada arquivo

Na coluna **Ações** de cada linha você encontra:

| Ícone       | O que faz                                           |
| ----------- | --------------------------------------------------- |
| ✏️ Lápis    | Abre o editor de código (só para arquivos de texto) |
| 👁️ Olho    | Mostra a pré-visualização (só para imagens)         |
| ⬇️ Seta     | Baixa o arquivo. Numa pasta, baixa tudo em `.zip`   |
| 🗑️ Lixeira | Exclui o arquivo ou a pasta com todo o conteúdo     |

## Editando direto no navegador

Precisa trocar um texto ou ajustar uma cor? Não precisa baixar, editar e enviar de novo. Clique no **lápis** (ou com o botão direito do mouse sobre o arquivo) e ele abre num editor de código em tela cheia.

Dá para editar arquivos `.html`, `.css`, `.js`, `.ts`, `.json`, `.txt`, `.md`, `.xml` e `.svg`.

Atalhos que funcionam no editor:

| Atalho     | Ação              |
| ---------- | ----------------- |
| `Ctrl + S` | Salvar            |
| `Ctrl + Z` | Desfazer          |
| `Ctrl + Y` | Refazer           |
| `Ctrl + F` | Buscar no arquivo |

Ao salvar, a alteração já vai para o ar.

## Excluindo vários de uma vez

Marque a caixinha ao lado de cada item (ou a do cabeçalho para marcar tudo da pasta aberta) e clique em **Excluir selecionados**. Antes de apagar, o painel mostra a lista do que vai sair, para você conferir.

{% hint style="danger" %}
Arquivo excluído não volta. Se estiver mexendo em algo importante, faça um [backup](/cloud-space/suspensao-reativacao-e-exclusao.md) antes.
{% endhint %}

## Não tenho o site pronto

Sem problema. O botão **Criar site com Builder AI**, na própria área de arquivos, abre o construtor com inteligência artificial para você gerar o site do zero e publicar no projeto.