# Comece aqui

## Onboarding em 15 minutos (1 → 2)

{% hint style="info" %}
Siga os passos em ordem.
{% endhint %}

Ao final, você terá:

* Um app rodando no **Preview** e **Navegador**
* Três mudanças aplicadas via **Chat AI**.

### Pré-requisitos (1 min)

* Você já criou sua conta e está logado.
* Você consegue ver a **Home** do Madrix.
* Você tem permissão para criar projetos.

{% stepper %}
{% step %}

### Crie seu primeiro projeto (5 min)

<sup>Prompt → Gerar Software → Preview.</sup>

* [ ] Clique em Novo Projeto
* [ ] Cole o prompt abaixo

```
Crie um projeto chamado: TaskFlow

Objetivo: um app simples de tarefas.

Módulos:
- Tarefas

Entidades:
- Tarefa:
  - titulo (obrigatório)
  - descricao
  - status (Novo | Em Progresso | Revisão | Concluído)
  - prioridade (Baixa | Média | Alta)
  - dataVencimento (data)
  - atribuidoA (relacionamento: 1 Usuário)

Regras de negócio:
- O status só pode avançar nesta ordem:
  Novo → Em Progresso → Revisão → Concluído
- Não permitir voltar status.

Telas mínimas:
- Lista de tarefas (filtro por status e prioridade)
- Criar/editar tarefa
- Detalhe da tarefa

Relatórios: nenhum.
```

* [ ] Clique em **Gerar** (ou pressione **Enter**)
* [ ] Aguarde o agente analista de requisitos gerar a especificação do app
* [ ] Revise a especificação e clique em **Aprovar**
* [ ] Assista os agentes de IA gerando o app
* [ ] Veja o app pronto no **Preview** ou clique no botão **Executar** <img src="/files/jus7CO9ujmcXgbbziY5V" alt="" data-size="original">
* [ ] Faça login no app com seu **usuário** e **senha**
* [ ] Crie, edite e remova tarefas pela lista de tarefas e pelo kanban

**Resultado esperado:** você consegue navegar e usar as funcionalidades do app.
{% endstep %}

{% step %}

### Evolua seu projeto (8 min)

<sup>Uso do modo Chat AI</sup>

* [ ] No Chat, escreva este prompt: "adicione um campo de anexo ao componente de tarefa"
* [ ] Aguarde o agente analista solicitar a aprovação dessa solicitação de mudança do app
* [ ] Aprove a solicitação de mudança
* [ ] Execute o app e veja no formulário de tarefa que agora existe um campo para adicionar arquivos

Agora aplique mais uma mudança:

* [ ] No Chat, escreva este prompt: "Adicione cadastro de projetos e associação de atividades com projetos"
* [ ] Aguarde a solicitação de mudança e aprove
* [ ] Execute o app e valide:
  * Existe um cadastro/lista de **Projetos**
  * Na criação ou edição de **Tarefas**, você consegue associar um **Projeto**

Agora aplique uma última mudança (tema):

* [ ] No na barra de ferramenta clique em Configurações do Projeto ![](/files/B8E1Pc1DrVYhxo7dqKa9)
* [ ] Clique em **Identidade Visual** e role a barra de rolagem até a seção *Cores do Tema*
* [ ] Selecione as cores **primária** e **secundária** e clique no botão **Salvar**
* [ ] Execute o app e confirme a alteração das cores (botões, header, highlights)

**Resultado esperado:** você consegue aplicar três mudanças no seu projeto.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Quer publicar na Cloud? Siga o tutorial **“Publique na Cloud (primeiro deploy)”** em [Tutoriais Práticos](/br/tutoriais-praticos.md).

Na mesma página, você também aprende a:

* Fazer mais mudanças no seu projeto
* Criar projetos mais avançados (modelos, UI, workflows, integrações).
* Trabalhar no modo **Editor** para ajustes avançados.
  {% endhint %}

### Se algo der errado (2 min)

* **Não gerou nada após o prompt:** tente novamente com um prompt menor. Recarregue a página.
* **Preview não abre:** desative adblock para o domínio. Teste em aba anônima.

Siga com:

* [Tutoriais Práticos](/br/tutoriais-praticos.md)
* [Demonstrações](/br/demonstracoes.md)
* [Troubleshooting](/br/solucao-de-problemas.md)

Atalhos de troubleshooting:

* Se a geração travar: [Falhas na geração por IA](/br/solucao-de-problemas/falhas-na-geracao-por-ia.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/comece-aqui.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.