Skip to content

[UFC-1588] [UFC-1182] Deprecate dojo and set the react client as the default #9520

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 10 commits into from
May 26, 2025
Merged

[UFC-1588] [UFC-1182] Deprecate dojo and set the react client as the default #9520

Show file tree
Hide file tree
Changes from 3 commits
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
a23fd3a
Deprecate dojo and set the react client as the default.
EnasAbdelrazek May 13, 2025
356f31f
Update _index.md
ConnorLand May 13, 2025
68ebfc0
Update wording
EnasAbdelrazek May 13, 2025
9e4c99e
Mention that React client is the default and dojo is deprecated
EnasAbdelrazek May 14, 2025
8d9cdb5
Added CSP setup instructions for React Client in version 11
EnasAbdelrazek May 14, 2025
e6cc7ab
Fixed typo
EnasAbdelrazek May 14, 2025
f859a45
Update the docs for version 10
EnasAbdelrazek May 14, 2025
f85dd7a
Fix typo
EnasAbdelrazek May 14, 2025
541a3bf
Fixed comments
EnasAbdelrazek May 15, 2025
e4dfe1f
Edit
ConnorLand May 26, 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
8 changes: 5 additions & 3 deletions content/en/docs/refguide/modeling/app-explorer/app/app-settings/_index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,10 +28,12 @@ These settings influence the behavior of the Runtime when running your applicati

### Use React Client {#react-client}

This setting enables the new React version of the Mendix Client. There are three options:
This setting enables the React version of the Mendix Client. In Mendix 11.0 and above, the React Client is the default for new applications and the legacy Dojo Client is deprecated.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I changed the version from "As of Mendix 11" to "In Mendix 11.0 and above". Is that a good change (more precise), or with APIs is it more appropriate to stick to only major versions (e.g. "As of Mendix 11)? @MarkvanMents

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That change is fine, Connor.
Also makes it less likely that we miss it when we move to Mendix 12.


* **No**: Do not use the React client (default).
* **Yes**: Use the React client. In this mode, you will get consistency errors for incompatible widgets.
The available configuration options are as follows:

* **No**: Do not use the React client. This option will trigger a deprecation warning, as the Dojo client is deprecated.
* **Yes**: Use the React client (default). In this mode, you will get consistency errors for incompatible widgets.
* **Migration mode**: Use the React client and ignore incompatible widgets. Placeholders are displayed in the case of incompatible widgets. Recommended when trying out the new client.

### Static Resources from Disk
Expand Down
4 changes: 3 additions & 1 deletion 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,7 +7,9 @@ weight: 10

## Introduction

There is an alternative version of the Mendix Client written in React. You can enable this React client in [App Settings](/refguide/app-settings/#react-client).
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).

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