> For the complete documentation index, see [llms.txt](https://docs.discloud.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.discloud.com/faq/general-questions/what-is-the-root-of-the-project.md).

# O que é a raiz do projeto?

Entenda a raiz do projeto (diretório base) para que a Discloud possa detectar configurações, dependências e seu arquivo principal corretamente.

## 🧾 Visão Geral

A raiz do projeto ("diretório raiz") é a **pasta de nível superior da sua aplicação,** a pasta cujo conteúdo você comprime e envia para a Discloud. Ela contém o arquivo de configuração ([`discloud.config`](https://docs.discloud.com/configurations/discloud.config.md)), manifesto de dependências (ex. [`package.json`](https://docs.discloud.com/development-environment/supported-languages/javascript/package-json.md), [`requirements.txt`](https://docs.discloud.com/development-environment/supported-languages/python/requirements.txt.md), [`Cargo.toml`](https://docs.discloud.com/development-environment/supported-languages/rust/cargo.toml.md), [`Gemfile`](https://docs.discloud.com/development-environment/supported-languages/ruby/gemfile.md)), opcional [`.env`](https://docs.discloud.com/faq/general-questions/.env-file.md), e as pastas com seu código fonte (ex. `src/`).

Se a estrutura estiver errada (por exemplo, você zipa uma pasta que contém outra pasta única que realmente contém os arquivos), a Discloud pode falhar em detectar o arquivo principal ou dependências.

***

## 🖼️ Exemplo Visual

A zona verde representa a **raiz** que você deve comprimir. Amarelo mostra uma pasta aninhada contendo arquivos de código. Tudo dentro do verde é incluído quando você comprime o conteúdo dessa pasta (deixe de fora pastas como `node_modules`).

<figure><img src="https://696530983-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvUqkKIFudeQ2TQOirm35%2Fuploads%2FioPCFiB1ESVJt6cYgGJO%2Fproject-root-structure-example.png?alt=media&amp;token=35019fda-f38b-4748-b4c0-684733db20f9" alt="Exemplo da raiz do projeto"><figcaption></figcaption></figure>

***

### 🚫 Erros Comuns

| Erro                                   | Resultado                                 | Correção                                                                                                                 |
| -------------------------------------- | ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| Compactar a pasta acima da raiz real   | Configuração / arquivo principal ausente  | Comprima o conteúdo da pasta que contém [`discloud.config`](https://docs.discloud.com/configurations/discloud.config.md) |
| Incluir `node_modules`                 | Upload grande, possíveis erros de tamanho | Remova e deixe a Discloud instalar                                                                                       |
| Tokens hardcoded no código             | Exposição de dados sensíveis              | Use [`.env`](https://docs.discloud.com/faq/general-questions/.env-file.md) e variáveis de ambiente                       |
| Múltiplos arquivos de entrada ambíguos | Falha na inicialização                    | Defina `MAIN` em [`discloud.config`](https://docs.discloud.com/configurations/discloud.config.md) explicitamente         |
