Get started here

This page is designed to get your first app running in 15 minutes.

Onboarding in 15 minutes (1 → 2)

Follow the steps in order.

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.

1

Create your first project (5 min)

^{Prompt → Generate Software → Preview.}

• 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
• 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.

2

Evolve your project (8 min)

^{Using Chat AI mode}

• 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
• 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.

Want to publish to the Cloud? Follow the tutorial "Publish to the Cloud (first deploy)" on Practical Tutorials.

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.

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
• Demonstrations
• Troubleshooting

Troubleshooting shortcuts:

• If generation stalls: AI generation failures