Changelog

#v2.1.0

#Cleaner Console Output

The native:run command now provides cleaner, more readable output, making it easier to follow what's happening during development.

#Improved Windows Support

Better compatibility and smoother development experience for Windows users.

#Blade Directives

New Blade directives for conditional rendering based on platform:

Copied!
Only rendered in mobile apps
@mobile / @endmobile
 
Only rendered in web browsers
@web / @endweb
 
Only rendered on iOS
@ios / @endios
 
Only rendered on Android
@android / @endandroid

#Improved File Watcher

The file watcher has been completely overhauled, switching from fswatch to Watchman for better performance and reliability. The watcher is now combined with Vite HMR for a unified development experience.

#Common URL Schemes

NativePHP now automatically handles common URL schemes, opening them in the appropriate native app:

  • tel: - Phone calls
  • mailto: - Email
  • sms: - Text messages
  • geo: - Maps/location
  • facetime: - FaceTime video calls
  • facetime-audio: - FaceTime audio calls

Support for custom deep links and app links on Android, allowing other apps and websites to link directly into your app.

#Other Changes

  • System::appSettings() to open your app's settings screen in the OS Settings app
  • Edge::clear() to remove all EDGE components
  • Added Native.shareUrl() to the JavaScript library
  • native:install: Added --fresh and -F as aliases of --force
  • native:install: Increased timeout for slower networks

#Bug Fixes

  • Fixed Scanner permissions
  • Fixed Android edge-to-edge display
  • Fixed Browser::auth on iOS
  • Fixed text alignment in native top-bar component on iOS
  • Fixed plist issues on iOS
  • Fixed NATIVEPHP_START_URL configuration
  • Fixed camera cancelled events on Android
  • Fixed bottom-nav values not updating dynamically

#v2.0.0

#JavaScript/TypeScript Library

A brand-new JavaScript bridge library with full TypeScript declarations for Vue, React, Inertia, and vanilla JS apps. This enables calling native device features directly from your frontend code. Read more about it here.

#EDGE - Element Definition and Generation Engine

A new native UI system for rendering navigation components natively on device using Blade. Read more about it here.

#Laravel Boost Support

Full integration with Laravel Boost for AI-assisted development. Read more about it here.

#Hot Module Replacement (HMR) Overhauled

Full Vite HMR for rapid development. Read more about it here.

Features:

  • Custom Vite plugin
  • Automatic HMR server configuration for iOS/Android
  • PHP protocol adapter for axios on iOS (no more patch-inertia command!)
  • Works over the network even without a physical device plugged in!

#Fluent Pending API (PHP)

All Asynchronous Methods now implement a fluent API for better IDE support and ease of use.

Fluent APIs
Copied! 
Dialog::alert('Confirm', 'Delete this?', ['Cancel', 'Delete'])
    ->remember()
    ->show();
Copied! 
import { dialog, on, off, Events } from '#nativephp';
const label = ref('');
 
const openAlert = async () => {
    await dialog.alert()
        .title('Alert')
        .message('This is an alert dialog.')
        .buttons(['OK', 'Cool', 'Cancel']);
};
 
const buttonPressed = (payload: any) => {
    label.value = payload.label;
};
 
onMounted(() => {
    on(Events.Alert.ButtonPressed, buttonPressed);
});

##[OnNative] Livewire Attribute

Forget the silly string concatenation of yesterday; get into today's fashionable attribute usage with this drop-in replacement:

Copied!
use Livewire\Attributes\OnNative; 
use Native\Mobile\Attributes\OnNative; 
 
#[On('native:'.ButtonPressed::class)] 
#[OnNative(ButtonPressed::class)] 
public function handle()

#Video Recording

Learn more about the new Video Recorder support here.

#QR/Barcode Scanner

Learn more about the new QR/Barcode Scanner support here.

#Microphone

Learn more about the new Microphone support here.

#Network Detection

Learn more about the new Network Detection support here.

#Background Audio Recording

Just update your config and record audio even while the device is locked!

Copied!
// config/nativephp.php
'permissions' => [
    'microphone' => true,
    'microphone_background' => true,
],

#Push Notifications API

New fluent API for push notification enrollment:

Push Notifications
Copied! 
use Native\Mobile\Facades\PushNotifications;
use Native\Mobile\Events\PushNotification\TokenGenerated;
 
PushNotifications::enroll();
 
#[OnNative(TokenGenerated::class)]
public function handlePushNotificationsToken($token)
{
    $this->token = $token;
}

Copied! 
import { pushNotifications, on, off, Events } from '#nativephp';
 
const token = ref('');
 
const promptForPushNotifications = async () => {
    await pushNotifications.enroll();
};
 
const handlePushNotificationsToken = (payload: any) => {
    token.value = payload.token;
};
 
onMounted(() => {
    on(Events.PushNotification.TokenGenerated, handlePushNotificationsToken);
});
 
onUnmounted(() => {
    off(Events.PushNotification.TokenGenerated, handlePushNotificationsToken);
});

Deprecated Methods:

  • enrollForPushNotifications() → use enroll()
  • getPushNotificationsToken() → use getToken()

#Platform Improvements

iOS

  • Platform detection - nativephp-ios class on body
  • Keyboard detection - keyboard-visible class when keyboard shown
  • iOS 26 Liquid Glass support
  • Improved device selector on native:run showing last-used device
  • Load Times dramatically improved. Now 60-80% faster!

Android

  • Complete Android 16+ 16KB page size compatibility
  • Jetpack Compose UI - Migrated from XML layouts
  • Platform detection - nativephp-android class on body
  • Keyboard detection - keyboard-visible class when keyboard shown
  • Parallel zip extraction for faster installations
  • Load Times dramatically improved. ~40% faster!
  • Page Load Times dramatically decreased by ~40%!

#Configuration

New Options

Copied!
'start_url' => env('NATIVEPHP_START_URL', '/'),
 
'permissions' => [
    'microphone' => false,
    'microphone_background' => false,
    'scanner' => false,
    'network_state' => true, // defaults to true
],
 
'ipad' => false,
 
'orientation' => [
    'iphone' => [...],
    'android' => [...],
],

Custom Permission Reasons (iOS)

Copied!
'camera' => 'We need camera access to scan membership cards.',
'location' => 'Location is used to find nearby stores.',

#New Events

  • Camera\VideoRecorded, Camera\VideoCancelled, Camera\PhotoCancelled
  • Microphone\MicrophoneRecorded, Microphone\MicrophoneCancelled
  • Scanner\CodeScanned

#Custom Events

Many native calls now accept custom event classes!

Copied!
Dialog::alert('Confirm', 'Delete this?', ['Cancel', 'Delete'])
    ->event(MyCustomEvent::class)

#Better File System Support

NativePHP now symlinks your filesystems! Persisted storage stays in storage but is symlinked to the public directory for display in the web view! Plus a pre-configured mobile_public filesystem disk.

Copied!
FILESYSTEM_DISK=mobile_public
Copied!
$imageUrl = Storage::url($path);
Copied!
<img :src="$imageurl" />

#Bug Fixes

  • Fixed infinite recursion during bundling in some Laravel setups
  • Fixed iOS toolbar padding for different device sizes
  • Fixed Android debug mode forcing APP_DEBUG=true
  • Fixed orientation config key case sensitivity (iPhone vs iphone)

#Breaking Changes

  • None
Previous
Quick Start
Next
Installation
Edit this page on GitHub