# Configurações do Projeto

Aqui você configura identidade, acesso e deploy do seu projeto.

Para segurança, autenticação e políticas do app em execução, use [Configurações do Runtime](/br/documentacao/configuracoes-do-runtime.md).

### Configurações básicas

Você pode ajustar:

* **Nome do projeto (Display Name** por idioma**)**
* **Deletar o projeto**

{% hint style="danger" %}
**Danger Zone: remover projeto**\
Essa ação é irreversível.\
Ela remove dados do projeto, componentes, menus e configurações.

Para confirmar, digite o **nome do projeto** e clique em **Confirmar deleção**.
{% endhint %}

### Identidade visual

Use para alinhar o app com sua marca.

Configurações comuns:

* **Ícone do projeto**
* **Dark Mode**
* **Contrast**
* **Right to Left (RTL)**
* **Compact**
* **Layout**
  * Menu à esquerda
  * Menu no topo
  * Menu à esquerda retraído
* **Fonte**
  * Font type
  * Font size
* **Cores do tema**
  * Primária
  * Secundária
  * Info
  * Success
  * Warning
  * Error

Finalize com **Salvar** ou descarte com **Cancelar**.

### Idiomas

Aqui você gerencia os idiomas habilitados no projeto.

Você pode:

* Ver a lista de idiomas configurados.
* Adicionar um idioma.
* Remover um idioma.

### Equipe do projeto

Use para compartilhar o projeto com outras pessoas da plataforma.

Cada membro pode ter um papel diferente (ex: administrador).

### GitHub

Conecte um repositório para sincronizar código e histórico.

Campos comuns:

* **Repository URL**
* **Branch**
* **Access Token**
* **Auto-sync enabled**

Fluxo típico:

1. Preencha URL, branch e token.
2. Clique em **Testar conexão**.
3. Clique em **Conectar**.

{% hint style="warning" %}
Use token com o menor escopo possível.\
Evite tokens pessoais compartilhados entre pessoas.
{% endhint %}

### Histórico de versões

Aqui você vê a pilha de versões do projeto.

Você pode:

* Identificar a **versão atual**.
* Executar uma versão específica.
* Reverter para uma versão anterior.

{% hint style="warning" %}
Reverter pode desfazer mudanças de UI e regras.\
Teste no Preview antes de publicar em produção.
{% endhint %}

### Ambientes Cloud

Um ambiente Cloud é onde seu app é publicado.

Exemplos:

* `Dev` para testes rápidos.
* `Staging` para homologação.
* `Prod` para usuários finais.

#### Criar e publicar um ambiente (fluxo recomendado)

{% stepper %}
{% step %}

### Criar o ambiente

Na lista de ambientes, clique em **Adicionar**.

Preencha:

* **Nome do ambiente**
* **Domínio externo** (opcional)
* **Servidor de aplicação**
* **Servidor de banco de dados**
* **Armazenamento de arquivos**

Clique em **Prosseguir para pagamento** ou **Cancelar**.
{% endstep %}

{% step %}

### Pagamento (Stripe)

O pagamento é processado de forma segura via Stripe.

Ao prosseguir, você verá a tela de checkout.
{% endstep %}

{% step %}

### Provisionamento (Not Ready → Ready)

Após o pagamento, o ambiente fica como **Not Ready** enquanto provisiona.

Aguarde cerca de **5 minutos**.
{% endstep %}

{% step %}

### Publicar

Quando estiver pronto, o status muda para **Ready**.

Se você clicar em **Publicar** antes disso, o indicador fica vermelho.

![](/files/ToVy9Wgts2d2HaSB0jHm)

Quando o ambiente estiver pronto, ele aparece em verde.

<figure><img src="/files/NAZWBTrR8GpQrLwwRFcF" alt=""><figcaption><p>Status pronto para publicar</p></figcaption></figure>

Selecione o ambiente e clique em **Publicar**.
{% endstep %}

{% step %}

### Aguardar e acessar

Após publicar, aguarde cerca de **3 minutos**.

Acesse o app pela URL do ambiente.

Na lista, ele deve aparecer como **Ready**.

<figure><img src="/files/UgDjWQ6aCiNRsxDsLtZ1" alt=""><figcaption><p>Ambiente publicado</p></figcaption></figure>
{% endstep %}
{% endstepper %}

#### Editar um ambiente

Para alterar configurações, clique na engrenagem do ambiente.

{% hint style="info" %}
Os ambientes são provisionados na AWS com IaC, containers, balanceamento de carga, auto-escalonamento e alta disponibilidade Multi-AZ.
{% endhint %}

### Próximos passos

* Ajustes finos no backend e scaffold: [Modo Editor](/br/documentacao/modo-editor.md)
* Visão geral do produto: [Plataforma](/br/documentacao/plataforma.md)
* Conexões com seu stack: [Integrações](/br/documentacao/integracoes-e-api.md)


---

# 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.madrix.dev/br/documentacao/configuracoes-do-projeto.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.