# 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="/files/60a9b24094b4e5632ca096f03b2216e30892490f" 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 ![](/files/48063584f45bd819a0d1a444f0b88f63b71cd201)
* [ ] 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](/hands-on-tutorials.md).

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](/hands-on-tutorials.md)
* [Demonstrations](/demonstrations.md)
* [Troubleshooting](/troubleshooting.md)

Troubleshooting shortcuts:

* If generation stalls: [AI generation failures](/troubleshooting/ai-generation-failures.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/get-started-here.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.