# O que é a raiz do projeto?

## 🧾 Visão Geral

A raiz do projeto ("diretório raiz") é a **pasta de nível superior da sua aplicação,** o lugar que você comprime e envia para a Discloud. Ela contém o arquivo de configuração ([`discloud.config`](https://docs.discloud.com/configurations/discloud.config)), manifesto de dependências (ex. [`package.json`](https://docs.discloud.com/development-environment/supported-languages/javascript/package-json), [`requirements.txt`](https://docs.discloud.com/development-environment/supported-languages/python/requirements.txt), [`Cargo.toml`](https://docs.discloud.com/development-environment/supported-languages/rust/cargo.toml), [`Gemfile`](https://docs.discloud.com/development-environment/supported-languages/ruby/gemfile)), opcional [`.env`](https://docs.discloud.com/faq/general-questions/.env-file), 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ê zipa esse diretório.

<figure><img src="https://696530983-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvUqkKIFudeQ2TQOirm35%2Fuploads%2Fgit-blob-595514ef31905b706f07359e103d721647f1cc5f%2Fchrome_TJemG9rsb0.png?alt=media" alt=""><figcaption></figcaption></figure>

***

### 🚫 Erros Comuns

| Erro                                            | Resultado                                 | Correção                                                                                                              |
| ----------------------------------------------- | ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| Compactar a pasta principal em vez da raiz real | Configuração / arquivo principal ausente  | Compacte diretamente a pasta que contém [`discloud.config`](https://docs.discloud.com/configurations/discloud.config) |
| Incluir `node_modules`                          | Upload grande; possíveis erros de tamanho | Remova; 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) 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) explicitamente         |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.discloud.com/faq/general-questions/what-is-the-root-of-the-project.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
