# 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](https://docs.madrix.dev/br/documentacao/configuracoes-do-runtime).

### 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.

![](https://2907154565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXnYvLewhXbdSQIvAlbqN%2Fuploads%2F0j9ss3y0MvrTgfch8JEI%2Fimage.png?alt=media\&token=a66ad703-919f-4d9d-a733-b5f09b96d6cd)

Quando o ambiente estiver pronto, ele aparece em verde.

<figure><img src="https://2907154565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXnYvLewhXbdSQIvAlbqN%2Fuploads%2F3d58JdG9W1qZ37vG1C30%2Fimage.png?alt=media&#x26;token=b599b48f-62b7-4957-88ae-4c0fa1beaffa" 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="https://2907154565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXnYvLewhXbdSQIvAlbqN%2Fuploads%2FMz63I8CpLzf3x54F3oeu%2Fimage.png?alt=media&#x26;token=9cd3b672-9d53-4cb5-b096-8f5c9605d30c" 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](https://docs.madrix.dev/br/documentacao/modo-editor)
* Visão geral do produto: [Plataforma](https://docs.madrix.dev/br/documentacao/plataforma)
* Conexões com seu stack: [Integrações](https://docs.madrix.dev/br/documentacao/integracoes-e-api)