Getting Started on Mobile

You need a NativeBlade project first. If you do not have one yet, follow the
Quick start to create and install it.

Add the platform

Add Android or iOS to your project:

php artisan nativeblade:add android
php artisan nativeblade:add ios

Run on a device or emulator

php artisan nativeblade:dev --platform=android
php artisan nativeblade:dev --platform=ios

Just like desktop, this builds the bundle and hot-reloads Blade, PHP, and CSS as
you edit, on the device, with no separate npm run build.

The phone reaches the Vite dev server on your machine over the LAN, so the two
must be on the same Wi-Fi. NativeBlade auto-detects your LAN IP; if it picks the
wrong interface (a VPN, several adapters), pass it explicitly:

php artisan nativeblade:dev --platform=android --host=192.168.1.11

Find your IP with ipconfig on Windows, or ifconfig / ip addr on macOS and
Linux. localhost does not work, because the phone cannot reach your machine
through it.

Easiest way: the Portal app

The NativeBlade Portal loads your dev app on a real device with no Android Studio
or Xcode build. Install it once:

Then run:

php artisan nativeblade:dev --platform=portal

Open the Portal app on your phone, scan the QR shown in your terminal (or paste
the URL), and your app loads in seconds. Switch projects by changing the URL, no
rebuild required. See Portal for details.