Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
92 changes: 86 additions & 6 deletions content/en/docs/developerportal/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,11 +20,91 @@ cascade:

## Creating an App {#create-app}

Follow these steps to create a new app and start collaborating:
There are two ways to create apps:

1. In **Apps**, click **Create App** in the upper-right corner. A screen opens to guide you through the process.
* Using Maia to plan and build your app.
* Using a starter app template.

2. Enter the following information for your app:
The following sections describe the process for each option.

### Creating an App with Maia

{{% alert color="warning" %}}
This feature is in Public Beta. For more information, refer to [Release Status](/releasenotes/release-status/).
{{% /alert %}}

Follow these steps to have Maia plan and generate an app for you:

1. In **Apps**, click **Create App** in the upper right corner.

2. Select **Plan & Build with Maia**.

3. In the **Project Context** text box, enter as much detail as possible about your future app. These are some details that you could add to help Maia generate an app for you:

* Describe your goals.
* Describe your targeted users.
* List out success criteria.
* Add requirements.
* Attach documents, sketches, images.

4. Click **Generate Plan**. The **Project Scope** window is displayed, and Maia starts populating it with the proposed project scope.
The app plan becomes available on the **Apps** page as soon as you click **Generate Plan** at the beginning of the workflow. As such, you can go back to the plan at any time after you leave it, and you can already add team members to the app.

Once the **Project Scope** window is populated, you can see the following information generated by Maia:

* **Goal** – A description of what you want to achieve through the app.
You can edit this description.

* **Success Criteria** – A list of criteria by which to measure the success of the app. You can perform the following actions:

* In-line edit criteria.
* Remove criteria by hovering over them, then clicking the trash can icon.
* Add new criteria by clicking **+Add New Success Criteria**.

* **Target Users** – Cards corresponding to the app's target users, along with each user's goal. You can perform the following actions:

* In-line edit user details.
* Remove users or their goals by hovering over them, then clicking the trash can icon.
* Add users by clicking **+Add New User**.
* Add user goals by clicking **+Add New User Goal**.

* **Requirements** – The features that the app must have. You can perform the following actions:

* In-line edit requirements.
* Remove features by hovering over them, then clicking the trash can icon.
* Add new features by clicking **+Add New Requirement**.

You can use the pane on the right to chat with Maia about your requirements for the new app.

5. Once you review the project scope and make any changes you deem necessary, click **Approve Project Scope** in the top right of the page. The status of the project scope changes from **Draft** to **Approved**.

6. Click **Generate Solution** in the top right of the page. The **Solution Proposal** window is displayed, and Maia starts populating it with the proposed project scope.
While the solution proposal is being generated, as well as after it's displayed, the **Project Scope** is locked. If you want to make changes to it, you can click the lock icon to unlock it.
Once the **Solution Proposal** window is populated, you can see the following information generated by Maia:

* Cards corresponding to each epic which contributes to building the app.
You can remove epics by hovering over them, then clicking the trash can icon.
Click the card itself to:

* See the entire list of stories for an epic in the right side panel.
* Edit the description or details of the epic.

You can perform the following actions on each story:

* To see the full details of a story or to edit it, click the three-dot menu, then select **Edit**.
* To remove a story, click the three-dot menu, then select **Delete**.

7. Once you are happy with Maia's suggested project plan, click **Open in Studio Pro** in the top right of the page. This opens Studio Pro, where you can continue working on the new app. For details, refer to [Maia Make](/refguide/maia-make/) in the Studio Pro documentation.

### Creating an App from a Starter App Template

Follow these steps to use a starter app:

1. In **Apps**, click **Create App** in the upper right corner.

2. Select **Use a Starter App**. A screen opens to guide you through the process.

3. Enter the following information for your app:

* **App name** – Every app must have a name that abides by these requirements:

Expand All @@ -36,15 +116,15 @@ Follow these steps to create a new app and start collaborating:

* **App icon** – Mendix has generated an icon for your app. You can change the color of the icon if you like. You can upload a custom icon in the [App Settings](/developerportal/general-settings/#general) page once you have created the app.

3. Click **Next** to go to step 2.
4. Click **Next** to go to step 2.

4. Select a starter app template on which the app will be based. The most used starter app templates are displayed.
5. Select a starter app template on which the app will be based. The most used starter app templates are displayed.

Some templates offer multiple versions for you to choose from, which are displayed as selectable options. By default, the stable version is pre-selected.

If you want to choose a different starter app template than the ones displayed, click the **discover community starter apps** link at the top. This takes you to the Marketplace, where you can browse through all available starter app templates and select one that suits your needs.

5. After selecting a starter app template, click **Create App**. Based on the starter app template you selected, it can take some time to set up the app, its repository, and access to the collaboration tools. After it is completed, the app is created.
6. After selecting a starter app template, click **Create App**. Based on the starter app template you selected, it can take some time to set up the app, its repository, and access to the collaboration tools. After it is completed, the app is created.

## My Apps {#my-apps}

Expand Down
7 changes: 7 additions & 0 deletions content/en/docs/releasenotes/developer-portal/2026.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,13 @@ description: "2026 release notes for app management and other parts of Apps"
weight: 1
---

## February 2026

### February 24, 2026

* You can now ask Maia to create a project plan for your new app. To do that, simply choose the **Plan & Build with Maia** option at the start of the app creation workflow, and provide as much information as you can about what you want from your future app. Maia will then suggest the basis for your app, such as goals, target users, requirements, epics, and stories, which you can edit to suit your needs.
For details, refer to the [Creating an App with Maia](/developerportal/#creating-an-app-with-maia) section of *Apps*.

## January 2026

### January 29, 2026
Expand Down
2 changes: 1 addition & 1 deletion layouts/partials/landingpage/latest-releases.html
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ <h4 class="lp-panel-title">Latest Releases</h4>
</li>
<li class="lp-panel-list">
<a href="/releasenotes/developer-portal/">Apps</a>
<p class="rn-date">January 29, 2026</p>
<p class="rn-date">February 24, 2026</p>
</li>
<li class="lp-panel-list">
<a href="/releasenotes/developer-portal/deployment/">Deployment</a>
Expand Down