Guides
CLI Commands

Commands

Every NativeBlade artisan command, grouped by what you reach for it. All are php artisan nativeblade:<name>.

Setup

`nativeblade:install`

Install NativeBlade into an existing Laravel project: scaffolds src-tauri, publishes layouts and the WASM app, patches config/* and .env for the client-side runtime, and runs the first config + icon pass.

php artisan nativeblade:install

`nativeblade:update`

Sync the project with the installed NativeBlade version after a composer update. Bumps the NativeBlade-managed package.json deps (the @php-wasm and @tauri-apps families, Vite, Tailwind) to the versions this release ships, adds any new ones, re-publishes vite.wasm.config.js from the current stub (so bundler/asset fixes propagate, the previous file is kept as .bak), regenerates the platform config, and runs npm install. Your own dependencies and the chosen @php-wasm/web-<php> variant are preserved; the framework runtime itself comes from the Composer package, so nothing is copied into your repo.

composer update nativeblade/nativeblade
php artisan nativeblade:update

`nativeblade:add {platform}`

Add a mobile platform scaffold (src-tauri/gen/...) to the project.

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

`nativeblade:php {version?}`

Set the PHP-WASM runtime version (must match your dev PHP, e.g. 8.5).

php artisan nativeblade:php 8.5

`nativeblade:icon {source?} {--bg=}`

Generate every platform icon from one 1024x1024 PNG.

php artisan nativeblade:icon resources/icon.png
php artisan nativeblade:icon resources/icon.png --bg=#0a0a0a

Develop

`nativeblade:dev {--platform=} {--host=} {--port=} {--build}`

Start the dev server with hot reload. --platform is desktop (default), android, ios, portal, or browser. --host overrides the auto-detected LAN IP for mobile; --port is the Vite port (default 1420); --build runs against built assets instead of the Vite server (no HMR).

browser skips Tauri and Rust entirely, it builds the WASM bundle and opens the app in your default browser. Native plugin actions are silent no-ops outside Tauri, so use it to iterate on UI/Livewire behavior, not native features.

php artisan nativeblade:dev                      # desktop, HMR
php artisan nativeblade:dev --platform=android   # install + run on device, HMR
php artisan nativeblade:dev --platform=portal    # serve for the Portal app (QR + URL)
php artisan nativeblade:dev --platform=browser   # open in the browser, no Rust/Tauri

`nativeblade:serve {--host=} {--port=}`

Serve just the Vite dev server + live Laravel bundle (no QR, no platform install). Build the Laravel bundle, watch for PHP/Blade changes, and serve. Pair it with a preview build (see nativeblade:build --host) so an installed dev-client connects to it. --host is the IP advertised for HMR (auto-detected if empty); --port defaults to 1420.

php artisan nativeblade:serve
php artisan nativeblade:serve --host=192.168.1.11 --port=1420

`nativeblade:component {name?}`

Scaffold a new NativeBlade component.

php artisan nativeblade:component card

`nativeblade:config`

Regenerate the Tauri config (manifest, capabilities, Info.plist, Gradle, etc.) from your PHP config. Runs automatically inside dev, serve, and build; run it directly after changing AppServiceProvider.

php artisan nativeblade:config

Build & release

`nativeblade:build {platform} {--targets=} {--host=} {--port=}`

Build the app. platform is android, ios, or desktop. --targets limits Android architectures (aarch64,armv7,x86_64,i686, default all).

--host switches to a preview / dev-client build: an installable debug artifact that loads the frontend live from a running dev server (HMR + live Laravel bundle) instead of bundling static assets. Install it once, then run nativeblade:serve/dev at the same host. Debug-only, never for stores. --port matches the dev server port (default 1420).

php artisan nativeblade:build android
php artisan nativeblade:build android --targets=aarch64,armv7
php artisan nativeblade:build ios
php artisan nativeblade:build desktop

# preview / dev-client (loads live from the dev server)
php artisan nativeblade:build android --host=192.168.1.11

Preview / dev-client builds (`--host`)

A preview build is an installable “dev client” (like Expo Go, but for your own app): it ships no static frontend, loading everything live from a running dev server instead. Install it once, then iterate with HMR + live Laravel bundle without rebuilding or re-deploying.

# 1. build the dev-client once, pointing at your dev host
php artisan nativeblade:build android --host=192.168.1.11 --port=1420 --targets=aarch64
# 2. install the APK in build/android/<version>-preview.apk
# 3. serve; the installed app reconnects with HMR
php artisan nativeblade:serve --host=192.168.1.11 --port=1420

What --host does:

Bakes frontendDist/devUrl = http://<host>:<port> into a debug build (debug enables http cleartext + easy install signing).
Skips the static frontend/bundle/wasm builds, they come live from the server.
Honors --targets (build only the device arch to keep it small) and strips native debug symbols automatically.

Port must match. The URL is baked into the artifact, so build and serve with the same --port (default 1420). Mismatched ports = the app can’t reach the server.

Size. Preview builds are debug, so the native .so is large even after symbol stripping (expect ~60–150 MB depending on arch count, vs ~10–30 MB for a release). Use --targets=aarch64 (single arch) to roughly halve it. This is a dev tool, never a store artifact.

Remote preview over a tunnel (ngrok, etc.). --host accepts a full URL (with scheme), so you can point the dev client at a public tunnel and preview from anywhere, not just the same Wi-Fi:

php artisan nativeblade:build android --host=https://abc123.ngrok-free.app --targets=aarch64

When --host contains ://, it is used verbatim (the --port is ignored, use the URL’s own port). An https tunnel also removes the cleartext requirement. Tunnel caveats to handle on your side:

Vite host allowlist: add the tunnel host to server.allowedHosts in vite.wasm.config.js, or Vite returns “Blocked request. This host is not allowed.”
HMR over the tunnel: set server.hmr.host / clientPort to the public host so the HMR socket reconnects through the tunnel.
ngrok free: the URL rotates on every restart (rebuild needed, use a reserved domain on a paid plan for a stable URL), and the browser-warning interstitial can block the WebView load.

`nativeblade:bundle {--tag=} {--channel=} {--shell=} {--no-dev}`

Build only the Laravel bundle (laravel-bundle.json.gz) for OTA bundle push, without rebuilding the native shell. --tag versions the output, --channel publishes under a release channel (e.g. beta), --shell sets the minimum shell version, --no-dev runs composer install --no-dev first.

php artisan nativeblade:bundle
php artisan nativeblade:bundle --channel=beta --tag=1.4.0

`nativeblade:sign {platform} {--alias=} {--validity=} {--keystore-path=} {--keystore-password=} {--key-password=}`

Configure release signing: Android keystore or iOS ExportOptions.plist. The keystore options support CI mode (pass paths/passwords non-interactively).

php artisan nativeblade:sign android
php artisan nativeblade:sign ios

`nativeblade:deeplinks {--team=} {--fingerprint=}`

Generate the .well-known association files (assetlinks.json + apple-app-site-association) for verified universal/app links. --team is your Apple Team ID; --fingerprint is the Android signing cert SHA-256.

php artisan nativeblade:deeplinks --team=ABCDE12345 --fingerprint=AA:BB:...

Tooling

`nativeblade:mcp {--test}`

Start the MCP server for AI coding agents (stdio JSON-RPC). --test runs a self-test and exits.

php artisan nativeblade:mcp
php artisan nativeblade:mcp --test

Typical flows

First run

php artisan nativeblade:install
php artisan nativeblade:dev

Mobile dev with HMR on a device

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

Preview / dev-client (install once, iterate live)

php artisan nativeblade:build android --host=192.168.1.11 --targets=aarch64   # install the APK once
php artisan nativeblade:serve --host=192.168.1.11                             # serve; the app reconnects with HMR

See Preview / dev-client builds for tunnels (ngrok), size, and caveats.

Release

php artisan nativeblade:sign android
php artisan nativeblade:build android

OTA update (no store)

php artisan nativeblade:bundle --channel=stable

Last updated:

Commands

Setup

nativeblade:install

nativeblade:update

nativeblade:add {platform}

nativeblade:php {version?}

nativeblade:icon {source?} {--bg=}

Develop

nativeblade:dev {--platform=} {--host=} {--port=} {--build}

nativeblade:serve {--host=} {--port=}

nativeblade:component {name?}

nativeblade:config