# 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="https://2907154565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXnYvLewhXbdSQIvAlbqN%2Fuploads%2FsE4o4thOQieRI7xv4E7y%2Fimage.png?alt=media&#x26;token=bffd4859-1fe2-41d5-bcf4-820b031392c6" 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 ![](https://2907154565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXnYvLewhXbdSQIvAlbqN%2Fuploads%2FCRskyTVmakaG3VyA26Ud%2Fimage.png?alt=media\&token=cc025f48-1de8-4219-ac09-ddfb19897f85)
* [ ] 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](https://docs.madrix.dev/br/tutoriais-praticos).

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](https://docs.madrix.dev/br/tutoriais-praticos)
* [Demonstrações](https://docs.madrix.dev/br/demonstracoes)
* [Troubleshooting](https://docs.madrix.dev/br/solucao-de-problemas)

Atalhos de troubleshooting:

* Se a geração travar: [Falhas na geração por IA](https://docs.madrix.dev/br/solucao-de-problemas/falhas-na-geracao-por-ia)