⚠️ Vite styles not loading in NativePHP build? Check public/hot

[emmaferdez]

Problem

When running the app with composer native:dev, styles load correctly.
But after building the app with php artisan native:build, all Vite assets fail to load.

In DevTools, you may see errors like:

GET http://[::1]:5173/resources/css/app.css net::ERR_CONNECTION_REFUSED

Cause

The file public/hot was still present when building the app.

When public/hot exists, Laravel's @vite() helper assumes a dev server is running and tries to load assets from port 5173 — which does not exist in the packaged NativePHP app.

Solution

Ensure public/hot is removed before building.

Example fix in config/nativephp.php:

php
'cleanup_exclude_files' => [
    'public/hot',
],

Or explicitly remove it in prebuild:

'prebuild' => [
    'php -r "file_exists(\'public/hot\') && unlink(\'public/hot\');"',
],

Maybe NativePHP could automatically remove public/hot during build, or mention this in the docs for Laravel + Vite users.