> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dscloud.pt/llms.txt
> Use this file to discover all available pages before exploring further.

# Empacotar e enviar um ZIP

> Monte um ZIP reproduzível e escolha entre painel e API v3.

## Estrutura do pacote

Compacte os arquivos do projeto, com `dscloud.config` na raiz do ZIP. Inclua o código, arquivos de dependências e outros recursos necessários ao runtime.

* projeto.zip/
  * dscloud.config
  * index.js
  * package.json

Para esse exemplo, execute na raiz do projeto. Se o projeto usa um lockfile ou diretórios de código, inclua-os na lista.

```bash macOS e Linux theme={null}
zip projeto.zip dscloud.config index.js package.json
unzip -l projeto.zip
```

```powershell Windows theme={null}
Compress-Archive -Path dscloud.config,index.js,package.json -DestinationPath projeto.zip
tar -tf projeto.zip
```

> [!WARNING]
>
> Exclua `.env`, tokens, chaves privadas e credenciais antes de criar o ZIP. Confira a lista de arquivos antes do envio.

## Escolha o destino

> [tab] Painel
>
> Abra [Novo deploy](https://dscloud.pt/deploy) e envie o ZIP de até **10 MiB**. Veja o [passo a passo do painel](https://docs.dscloud.pt/getstarted/deploy-panel.md).

> [tab] API v3
>
> Envie o campo `file` em `multipart/form-data` para [`POST /v3/apps`](https://docs.dscloud.pt/api-reference/endpoint/apps/upload), com uma [chave de API](https://docs.dscloud.pt/api-reference/authentication.md). O middleware aceita arquivos de até **100 MiB**. Guarde o `id` retornado e consulte o [estado da aplicação](https://docs.dscloud.pt/api-reference/endpoint/apps/status.md).
>
> ```bash cURL theme={null}
> : "${DSCLOUD_API_BASE_URL:=https://api.dscloud.pt/v3}"
> curl --proto '=https' --fail-with-body --request POST \
>   --header "Authorization: ${DSCLOUD_API_KEY:?Defina DSCLOUD_API_KEY}" \
>   --form "file=@projeto.zip;type=application/zip" \
>   "${DSCLOUD_API_BASE_URL%/}/apps"
> ```
>
> Para enviar código novo a uma aplicação existente, use [`POST /v3/apps/{appId}/commit`](https://docs.dscloud.pt/api-reference/endpoint/apps/commit).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.