Non-ASCII APP_NAME stops built application from launching

[justrau]

What were you trying to do?

Set my app name to a non-ASCII value (APP_NAME=MUNĖ) — the letter Ė is Lithuanian. I expected the app to launch normally with the non-ASCII name displayed in the dock, menu bar, and window title.

What happened?

The app builds successfully but fails to launch. The main Electron process starts (menu bar icon appears) and pegs the CPU at ~100%, but no window ever opens. No child processes are spawned (no PHP server, no GPU helper, no renderer).

The root cause is likely that productName in electron-builder flows into the macOS executable name, helper app names (MUNĖ Helper (GPU).app, etc.), and framework paths. Electron's internal helper process resolution breaks with non-ASCII characters in these paths.

How to reproduce the bug

1. Set APP_NAME=MUNĖ (or any non-ASCII name) in .env
2. Build: php artisan native:build
3. Launch the built app
4. Main process spins at 100% CPU, no window appears
5. ps aux shows only the main process — no helper processes spawned

Debug Output

{
"Environment": {
"PHP": {
"Version": "8.4.18",
"Path": "/opt/homebrew/Cellar/php@8.4/8.4.18/bin/php"
},
"Laravel": {
"Version": "12.53.0",
"ConfigCached": false,
"RoutesCached": false,
"DebugEnabled": true
},
"Node": {
"Version": "v22.21.1",
"Path": "/Users/justas/.local/state/fnm_multishells/74682_1773427820233/bin/node"
},
"NPM": {
"Version": "11.6.2",
"Path": "/Users/justas/.local/state/fnm_multishells/74682_1773427820233/bin/npm"
},
"OperatingSystem": "Darwin",
"ElectronRoot": "vendor/nativephp/desktop/resources/electron"
},
"NativePHP": {
"Versions": {
"nativephp/desktop": "2.1.1.0",
"nativephp/php-bin": "1.1.1.0"
},
"Configuration": {
"Provider": "App\Providers\NativeAppServiceProvider",
"BuildHooks": {
"Pre": [],
"Post": []
},
"NotarizationEnabled": false,
"AzureTrustedSigningEnabled": false,
"CustomPHPBinary": false
}
}
}

Which operating systems have you seen this occur on?

macOS

Notes

No response