# 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)