# Welcome!

Madrix is a platform for **designing, generating and operating** corporate apps with AI.

You describe what you want.\
Agents execute deterministic tools.\
You review, approve and publish.

### What you can build

Use Madrix to create:

* CRMs, helpdesks and backoffices.
* Internal portals and operational flows.
* Apps with business rules, permissions and environments (Dev/Staging/Prod).

{% hint style="info" %}
Here “agentic AI” means: the AI **not only writes text**. It **executes actions** via tools, with traceability and approval checkpoints.
{% endhint %}

### Get started now (15 min)

Follow the onboarding and have your first app running:

* [Start here](https://app.gitbook.com/s/XnYvLewhXbdSQIvAlbqN/comece-aqui)

If you prefer to start with ready-made examples:

* [Prompt Templates](https://app.gitbook.com/s/XnYvLewhXbdSQIvAlbqN/tutoriais-praticos/4.-templates-de-prompt)

Then, deepen with:

* [Hands-on Tutorials](https://app.gitbook.com/s/XnYvLewhXbdSQIvAlbqN/tutoriais-praticos)
* [Demonstrations](https://app.gitbook.com/s/XnYvLewhXbdSQIvAlbqN/demonstracoes)

### How to navigate the documentation

Choose a path and follow the links:

{% tabs %}
{% tab title="Build fast" %}

* Complete onboarding: [Start here](https://app.gitbook.com/s/XnYvLewhXbdSQIvAlbqN/comece-aqui)
* Ready prompts: [Prompt Templates](https://app.gitbook.com/s/XnYvLewhXbdSQIvAlbqN/tutoriais-praticos/4.-templates-de-prompt)
* Guided examples: [Demonstrations](https://app.gitbook.com/s/XnYvLewhXbdSQIvAlbqN/demonstracoes)
  {% endtab %}

{% tab title="Product / Platform" %}

* Overview of the blocks: [Platform](https://app.gitbook.com/s/XnYvLewhXbdSQIvAlbqN/documentacao/plataforma)
* AI Features: [AI and Agentic Coding](https://app.gitbook.com/s/XnYvLewhXbdSQIvAlbqN/documentacao/modo-chat-ai)
* Deepen by topic: [Hands-on Tutorials](https://app.gitbook.com/s/XnYvLewhXbdSQIvAlbqN/tutoriais-praticos)
  {% endtab %}

{% tab title="IT / Integrations / Ops" %}

* Connect with your stack: [Integrations and API](https://app.gitbook.com/s/XnYvLewhXbdSQIvAlbqN/documentacao/integracoes-e-api)
* Governance and security: [Security and Compliance (IT)](https://app.gitbook.com/s/XnYvLewhXbdSQIvAlbqN/documentacao/configuracoes-do-runtime)
* Deployment and operation: [Deployment and Ops](https://docs.madrix.dev/broken-reference)
  {% endtab %}

{% tab title="Troubleshooting" %}

* When stuck: [Troubleshooting](https://app.gitbook.com/s/XnYvLewhXbdSQIvAlbqN/solucao-de-problemas)
  {% endtab %}
  {% endtabs %}

### How it works (quick view)

1. **Prompt** with objective, modules, entities and rules.
2. **Specification** to review and approve.
3. **Generation** of backend, UI and integrations.
4. **Preview** to test the app.
5. **Deploy** to environments (Dev/Staging/Prod).

### Concepts (in 2 minutes)

* **Project**: the “container” of your app.
* **Environment**: where the app runs (Dev/Staging/Prod).
* **Module**: a functional domain (e.g.: Tasks, Customers).
* **Entity**: the main data of the domain (e.g.: Task, Customer).
* **Business rule**: validations and automations of the process.
* **Roles and permissions (RBAC)**: who can see and do what.

### What to expect

1. **Ease of use**
   * Guided interface.
   * Clear flow from prompt → approval → execution.
2. **Flexibility**
   * Models and rules adapted to your business.
   * Iterative evolution with Chat AI and Editor.
3. **Efficiency**
   * Less time between idea and running app.
   * Less rework with approved specification.
4. **Collaboration**
   * Teams work on the same project.
   * Roles and permissions for governance.

### Next steps

* Understand the main blocks: [Platform](https://app.gitbook.com/s/XnYvLewhXbdSQIvAlbqN/documentacao/plataforma)
* Explore AI features: [AI and Agentic Coding](https://app.gitbook.com/s/XnYvLewhXbdSQIvAlbqN/documentacao/modo-chat-ai)
* Connect with your stack: [Integrations and API](https://app.gitbook.com/s/XnYvLewhXbdSQIvAlbqN/documentacao/integracoes-e-api)
* Grab ready-made prompts: [Prompt Templates](https://app.gitbook.com/s/XnYvLewhXbdSQIvAlbqN/tutoriais-praticos/4.-templates-de-prompt)
* If you get stuck on something: [Troubleshooting](https://app.gitbook.com/s/XnYvLewhXbdSQIvAlbqN/solucao-de-problemas)


---

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