The NUI is blank or white
A menu opens as a blank or white box, usually because some of its files are missing from the download.
Do this first
Re-download the script — an incomplete extraction is the usual cause.
What it means
The browser opened and rendered nothing. The interface is running — you can usually see it took focus — but the page itself failed to load or failed to paint.
What causes it
Ordered by how often it is the answer.
- 1
A file the page needs is not in the manifest's files list
Everything the page loads (HTML, CSS, JS, images, fonts) must be declared in
files {}. Undeclared files 404 and the page comes up empty. - 2
ui_page points at the wrong path
It is relative to the resource root.
- 3
A build output folder that was never built
React and Vue UIs load from
dist/orbuild/. Shipping the source without the build gives a blank page. - 4
A JavaScript error on the page
One uncaught error during boot leaves an empty root element.
- 5
Absolute paths that do not resolve
/assets/x.pngresolves to the nui root, not the resource. Relative paths work; absolute ones usually do not.
How to tell which one is yours
Open the NUI dev tools with nui_devtools in the F8 console. The console and network tabs answer this in seconds: 404s mean the files list, a red error means the page's own JavaScript.
Where to look
fxmanifest.lua's ui_page and files entries, and the browser console.
How to fix it
fx_version 'cerulean'
game 'gta5'
ui_page 'web/dist/index.html'
files {
'web/dist/index.html',
'web/dist/**/*', -- globs work and save a lot of grief
}Still stuck on your own code?
This page is what this error usually means. Paste your console into Server Fixer and it will rank everything in it and tell you what to do first, and if you would rather not touch it, ORBIE can repair the script and hand the resource back ready to drop in.
bug_reportOpen Server Fixer