# Get started here

## Onboarding in 15 minutes (1 → 2)

{% hint style="info" %}
Follow the steps in order.
{% endhint %}

At the end, you will have:

* An app running on the **Preview** and **Browser**
* Three changes applied via **AI Chat**.

### Prerequisites (1 min)

* You have already created your account and are logged in.
* You can see the **Home** of Madrix.
* You have permission to create projects.

{% stepper %}
{% step %}

### Create your first project (5 min)

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

* [ ] Click New Project
* [ ] Paste the prompt below

```
Create a project named: TaskFlow

Goal: a simple task app.

Modules:
- Tasks

Entities:
- Task:
  - title (required)
  - description
  - status (New | In Progress | Review | Done)
  - priority (Low | Medium | High)
  - dueDate (date)
  - assignedTo (relationship: 1 User)

Business rules:
- The status may only advance in this order:
  New → In Progress → Review → Done
- Do not allow status to go backwards.

Minimum screens:
- Task list (filter by status and priority)
- Create/edit task
- Task detail

Reports: none.
```

* [ ] Click **Generate** (or press **Enter**)
* [ ] Wait for the requirements analyst agent to generate the app specification
* [ ] Review the specification and click **Approve**
* [ ] Watch the AI agents generate the app
* [ ] See the finished app on the **Preview** or click the **Run** <img src="https://1206200624-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">
* [ ] Log in to the app with your **username** and **password**
* [ ] Create, edit and remove tasks from the task list and the kanban

**Expected result:** you can navigate and use the app's features.
{% endstep %}

{% step %}

### Evolve your project (8 min)

<sup>Using Chat AI mode</sup>

* [ ] In the Chat, write this prompt: "add an attachment field to the task component"
* [ ] Wait for the analyst agent to request approval for this app change
* [ ] Approve the change request
* [ ] Run the app and see in the task form that there is now a field to add files

Now apply one more change:

* [ ] In the Chat, write this prompt: "Add project registration and association of activities with projects"
* [ ] Wait for the change request and approve
* [ ] Run the app and validate:
  * There is a registration/list of **Projects**
  * When creating or editing **Tasks**, you can associate a **Project**

Now apply one last change (theme):

* [ ] In the toolbar click Project Settings ![](https://1206200624-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)
* [ ] Click **Visual Identity** and scroll the scrollbar to the *Theme Colors*
* [ ] Select the **primary** and **secondary** and click the **Save**
* [ ] Run the app and confirm the color change (buttons, header, highlights)

**Expected result:** you can apply three changes to your project.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Want to publish to the Cloud? Follow the tutorial **"Publish to the Cloud (first deploy)"** on [Practical Tutorials](https://app.gitbook.com/s/XnYvLewhXbdSQIvAlbqN/tutoriais-praticos).

On the same page, you also learn how to:

* Make more changes to your project
* Create more advanced projects (models, UI, workflows, integrations).
* Work in **Editor** mode for advanced adjustments.
  {% endhint %}

### If something goes wrong (2 min)

* **Nothing generated after the prompt:** try again with a shorter prompt. Reload the page.
* **Preview won't open:** disable adblock for the domain. Test in an incognito tab.

Proceed with:

* [Practical Tutorials](https://app.gitbook.com/s/XnYvLewhXbdSQIvAlbqN/tutoriais-praticos)
* [Demonstrations](https://app.gitbook.com/s/XnYvLewhXbdSQIvAlbqN/demonstracoes)
* [Troubleshooting](https://app.gitbook.com/s/XnYvLewhXbdSQIvAlbqN/solucao-de-problemas)

Troubleshooting shortcuts:

* If generation stalls: [AI generation failures](https://app.gitbook.com/s/XnYvLewhXbdSQIvAlbqN/solucao-de-problemas/falhas-na-geracao-por-ia)