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

# base44 site deploy

> Implanta arquivos de site construídos na hospedagem da Base44.

<Warning>
  Esta página faz parte de uma habilidade de agente de código IA e é escrita para agentes, não para humanos. Para a documentação legível por humanos da Base44, veja a [documentação para desenvolvedores](/developers).
</Warning>

# base44 site deploy

Implanta arquivos de site construídos na hospedagem da Base44.

## Índice

* [Sintaxe](#syntax)
* [Autenticação](#authentication)
* [Pré-requisitos](#prerequisites)
* [Como funciona](#how-it-works)
* [Fluxo interativo](#interactive-flow)
* [Fluxo típico](#typical-workflow)
* [Configuração](#configuration)
* [Tratamento de erros](#error-handling)
* [Casos de uso](#use-cases)
* [Notas](#notes)

## Sintaxe

```bash theme={null}
npx base44 site deploy [options]
```

## Opções

| Opção       | Descrição                    |
| ----------- | ---------------------------- |
| `-y, --yes` | Pula o prompt de confirmação |

Use a flag `-y` para implantações não interativas/automatizadas:

```bash theme={null}
npx base44 site deploy -y
```

## Autenticação

**Obrigatório**: Sim. Se não estiver autenticado, você será solicitado a fazer login primeiro.

## Pré-requisitos

* Deve ser executado a partir de um diretório de projeto Base44
* O projeto deve ter `site.outputDirectory` configurado na configuração do projeto
* O site deve ser construído antes de implantar (execute seu comando de build primeiro)
* **Apenas SPA**: A hospedagem da Base44 suporta aplicativos de página única com um único ponto de entrada `index.html`. Todas as rotas são servidas de `index.html` (roteamento no lado do cliente).

## Como funciona

1. Lê a configuração do projeto
2. Valida que a configuração do site existe
3. Solicita confirmação da implantação mostrando o diretório de saída
4. Cria um arquivo de arquivos do site do diretório de saída
5. Implanta na hospedagem da Base44
6. Retorna a URL do aplicativo

## Fluxo interativo

```bash theme={null}
$ npx base44 site deploy

Deploy site from ./dist? (yes/no) yes

Creating archive...
Uploading to Base44...
Deploying...

✓ Deployment successful!

Visit your site at: https://my-app.base44.app
```

## Fluxo típico

```bash theme={null}
# 1. Construa seu site usando o comando build do seu framework
npm run build

# 2. Implante na Base44
npx base44 site deploy
```

## Configuração

O `site.outputDirectory` na configuração do seu projeto deve apontar para onde seu framework gera arquivos construídos:

* Vite: normalmente `./dist`
* Next.js: normalmente `./.next` ou `./out`
* Create React App: normalmente `./build`
* Personalizado: para onde sua ferramenta de build gera saída

## Tratamento de erros

Se a configuração do site estiver ausente:

```bash theme={null}
$ npx base44 site deploy
Error: No site configuration found in project
```

Se você cancelar a implantação:

```bash theme={null}
Deploy site from ./dist? (yes/no) no
Deployment cancelled
```

## Casos de uso

* Implantar seu site após fazer alterações
* Enviar novas versões do seu aplicativo
* Implantar após atualizar conteúdo ou funcionalidade
* Parte do seu pipeline de CI/CD

## Notas

* Sempre construa seu site antes de implantar
* O comando implanta o que estiver no seu diretório de saída
* Certifique-se de que seu build foi concluído com sucesso antes de implantar
* Implantações anteriores são preservadas (com versão) na Base44
* A implantação é imediata e atualiza seu site ativo

<Note>Esta página foi traduzida usando IA. Para informações mais precisas e atualizadas, consulte a [versão em inglês](/). </Note>