After updating to the latest version of Solar2D (2026.3727), I’m running into an issue with the HTML5 build.
When the game starts, the splash screen appears, but once it finishes, the loading/progress bar gets stuck and never advances. Visually, the screen looks broken, as if it’s split into two horizontal sections, and the game never proceeds past that point.
This behavior did not happen before the update, so it seems to be related to the most recent HTML5 changes.
I’ve attached a short video where the bug can be clearly seen.
Update:
I’ve narrowed down the cause of the issue. The freeze only happens when creating an image using display.newImageRect.
This line:
local fondo = display.newImageRect("assets/img/background.jpg", 1536, 2048)
works correctly in the Solar2d simulator, but in the HTML5 build it causes the loading screen to get stuck (progress bar frozen and screen visually split).
If I replace it with a simple rectangle, the problem does not occur:
local fondo = display.newRect(sceneGroup, xs, ys, sW, sH)
So the issue seems to be specifically related to loading a JPG image via display.newImageRect in the current HTML5 runtime.
In the Chrome DevTools console, the following error is reported:
Uncaught RuntimeError: function signature mismatch
I’ve just tested a simple HTML5 project and can confirm that the latest version of Solar2D throws an error when attempting to load a JPG image.
UPDATE:
I have tested Solar2D 2025.3726, and the issue also persists in this version.
The last version I was using before testing 2026.3727 and 2025.3726 was 2025.3724, and this bug did not occur in that version.
Tested with version 3725, and the bug occurs there as well.