Skip to content

Updated React client doc #10201

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Oct 29, 2025
Merged

Updated React client doc #10201

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
35cdaf8
Added an alert clarifying our plans on removal of the Dojo client. Ba…
exec-astraea Oct 8, 2025
4bca674
Proofread
MarkvanMents Oct 29, 2025
c2bdfcd
Add removal information to 11.0 release note about Dojo deprecation
MarkvanMents Oct 29, 2025
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
4 changes: 4 additions & 0 deletions content/en/docs/refguide/runtime/mendix-client/react.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,10 @@ weight: 10

## Introduction

{{% alert color="warning" %}}
The Dojo client is deprecated and will be removed in Mendix 12. It continues receiving security and stability updates until the end of support of Mendix 11.24.
{{% /alert %}}

The Mendix Client has transitioned to a modern implementation using React. As of Mendix 11, the React Client is the default for all new applications created in Studio Pro, and the legacy Dojo client has been deprecated.

You can enable the React client for existing applications in [App Settings](/refguide/app-settings/#react-client).
Expand Down
25 changes: 25 additions & 0 deletions content/en/docs/refguide10/runtime/mendix-client/react.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,10 @@ weight: 10

## Introduction

{{% alert color="warning" %}}
The Dojo client is deprecated and will be removed in Mendix 12. It continues receiving security and stability updates throughout the lifetime of Mendix 10.24 LTS.
{{% /alert %}}

In Studio Pro versions 10.7.0 and above, there is an alternative version of the Mendix Client written in React. You can enable this React client in [App Settings](/refguide10/app-settings/#react-client).

The React client replaces [Dojo](https://dojotoolkit.org/) with [React](https://react.dev/) for the view layer. This change allows for improved performance, enables incremental loading, and future-proofs your application. For more information on these three aspects, see the sections below:
Expand Down Expand Up @@ -119,6 +123,13 @@ To automatically convert a reference selector widget or a drop-down to a combo b
Because the reference set selector widget is technically a grid, while combo box is a drop-down, only the applicable configuration options will be transferred to the resulting combo box during conversion.
{{% /alert %}}

#### HTML / JavaScript Snippet

The [HTML/JavaScript snippet](/appstore/widgets/html-javascript-snippet/) widget is not supported in the React Client. To leverage React, this widget can be replaced using [HTML Element](/appstore/widgets/htmlelement/) widget or [JavaScript actions](/refguide10/javascript-actions/):

* **Content Type** HTML — The HTML Element can be downloaded [here](https://marketplace.mendix.com/link/component/204843).
* **Content Type** JavaScript — Write the code inside the supported JavaScript actions. If the user needs to execute the code in a certain way, calling the JavaScript action via nanoflow that triggers by [Events](/appstore/widgets/events/) widget is recommended.

#### Data Grid{#data-grid}

The data grid widget is not supported in the React client. To leverage React, replace it with the [Data Grid 2](/appstore/modules/data-grid-2/) widget. The data grid 2 widget is part of the [Data Widgets Module](https://marketplace.mendix.com/link/component/116540) in the Mendix Marketplace.
Expand All @@ -137,6 +148,20 @@ To replace a template grid widget, follow these steps:
1. Add any actions that items from your original widget as icon buttons to the content area.
1. Add any actions that do not affect rows as buttons to the gallery widget's header.

#### Feedback Widget

The deprecated feedback widget is not supported in the React client. It should be replaced with the [Mendix Feedback Module](https://marketplace.mendix.com/link/component/205506). This module requires some additional configuration to work with the React client:

1. Install the latest version of the Feedback Module.
1. Replace the widget or snippet on your main layout(s) with the snippet `FeedbackModule.FeedbackWidget`.
1. Edit the properties of the widget inside the `FeedbackWidget` snippet (use the Page Explorer or Structure Mode to see it).
1. Set the **Modal pop-up type** to **Custom**.
1. Set the **On click action** to **Show a page** and choose the page `FeedbackModule.ShareFeedback`.

#### Sign In Widgets

The React client does not support the default Sign In widgets (Username, Password, Sign In Button). Use a modeled login page instead, leveraging an NPE to store credentials and a Nanoflow for authentication. Refer to the Atlas login page template for implementation guidance.

#### Custom Widgets{#custom-widgets}

Dojo widgets are no longer supported in the React client. They should be replaced with a pluggable widget based on React.
Expand Down
2 changes: 1 addition & 1 deletion content/en/docs/releasenotes/studio-pro/11/11.0.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -249,7 +249,7 @@ For details on upgrading to Studio Pro 11, see [Upgrading from Mendix Studio Pro
* We deprecated the following methods of the class `com.mendix.core.actionmanagement.internal.InternalCoreAction`: `addDatavalidationFeedback(IMendixIdentifier, Map<String, String>)`, `addDataValidationFeedback(DataValidationInfo)`, `handleConcurrentExecution()`, `setEventObjects(List<IMendixObject>)`, `setMetaInfo(JSONObject)`, `setActionName(String)`, `getException()`, `setException(Exception)`, `getState()`, `setState(ActionState)`, `setAllowsConcurrentExecution(Boolean)`, `clone()`. There is no replacement as these method were meant for internal usage only.
* We deprecated the `FeedbackHelper.OpenFormFeedback` methods with the `currentIdentifier` argument. Please use the methods where arguments for the page are passed as a `Map`.
* We have deprecated the `com.mendix.core.actionmanagement.internal.InternalCoreAction#setContext(IContext)` method. There is no replacement, this method was meant for internal usage only.
* We deprecated the Dojo Client. Please switch to the React Client. For more information, see the Mendix React Client’s [Migration Guide](/refguide/mendix-client/react/#migration-guide).
* We deprecated the Dojo Client and it will be removed in Mendix 12. Please switch to the React Client. For more information, see the Mendix React Client’s [Migration Guide](/refguide/mendix-client/react/#migration-guide). The Dojo client will continue receiving security and stability updates until the end of support of Mendix 11.24.
* We removed the deprecated entity access rules editor. For information on how to use the modernized entity access rules editor, see [Access Rules](/refguide/access-rules/).
* We deprecated the values `true` and `false` for the `com.mendix.storage.PerformDeleteFromStorage` runtime setting. Please use `NoFiles`, `TemporaryFiles` or `AllFiles` instead.
* We deprecated the constructors of the `com.mendix.core.actionmanagement.EventActionInfo` class with a `returnType` parameter. This parameter is not used internally and does not give any useful information.
Expand Down