Delivering raw HTML as the home page

0
Can Mendix deliver raw HTML as the home page, without it being part of the front-end app?I am using Mendix as the backend to a custom client application. The front-end is hand-coded HTML, and Mendix is supplying a web service to power it.I would like the home page of my app to be a raw HTML page. I am publishing that page to a subdirectory in the theme directory. It will respond just fine to:/my-folder/my-page.html How can I get Mendix to deliver this as the home page of the app? If not this actual page, how can I get Mendix to deliver a string of raw, unmodified HTML as the home page of an app?
asked
3 answers
0

In Mendix, the root URL (/) is designed to always serve the Mendix index.html file. There is no built-in setting that lets you tell the runtime to serve arbitrary raw HTML as the homepage instead.


What you can do is override the default file by placing your own index.html inside the theme/web/ folder. In that case, your HTML page will load at the root URL. However, this also means the Mendix client will not start there anymore. You are effectively serving only your static page instead of the Mendix app UI.


answered
0

This works locally.


But, sadly, the build on the Mendix Cloud fails when you do this.

[compile] 2026-02-11T00:15:03.663323750Z ERROR at (unknown location): theme/web/index.html does not contain the expected elements for the React client. This can happen when switching between the Dojo and React client without updating the template, or when manually editing the template.
[compile] 2026-02-11T00:15:03.665590222Z BUILD FAILED


answered
0

You can follow this document. Also, if there are any parts that belong to Dojo or are deprecated, you need to remove them.





answered